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1*0 PREFACE 



1.0 ££££&££ 



8 

i.l SCQP5 Qf .OflCUHENI 9 

18 
This document is intended to contain the information 111 
necessary for use of the NOS 170 prototype version of SCU by a lit 
terminal or batch user. Since there are some features which 1 13 
are of necessity operating system or machine dependent and 11* 
because not ail features which will appear in the NCS/VE 115 
implementation will be present in the prototype these two IIS 
implementations are being described in separate documents* HI 
The revision bars shown in this document have been generated 118 
relative to the ERS For Source Code Utility DCS number ARH1766 119 
revision G« That was the last ERS submitted to DCS which 120 
attempted to describe both implementations. An ERS describing 121 
the NOS/VE version of the utility will be submitted to DCS 122 
under another number. 123 

2* 

25 

1.2 APPLICABLE DOCUMENTS 26 

27 
Document PCS Number 1 2 8 

SES User's Handbook ARH1833 129 

NOS Reference Hanual 130 

NOS/VE ERS - Command Interface ARH3609 13t 

CYBER 180 System Interface Standard S2196 132 

33 
3% 
35 
36 
37 
38 
39 
<»3 
hi 
k2 

V5 
k5 
**S 
<*7 
¥8 
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2.0 INTRODUCTION 



2*0 INTRODUCTION i 

2 

3 

h 

$ 

6 

The purpose of this document is to describe the NOS 170 3 f 

prototype version of a utility which will provide for I 8 

introduction and maintenance of ASCII source data on the Cyber 9 

180* While emphasis is placed on the control and IS 

documentation necessary in large development groups* it can be it 

used by individuals maintaining private source libraries, 12 

13 
The utility described below includes an interactive editor ti% 
allowing for interactive development of new source units or 115 
corrections to existing source units. It provides multi_deck 116 
and build capabilities* allows for grouping of source decks 11? 
and correction sets into larger identifiable units and SIS 
associates descriptive information with source decks and 119 
correction sets, 12® 

21 

The commands described in this document make use of the 122 

System Command Language <SCL) syntax which has been defined 123 

for NOS/VE* the operating system that will execute on Cyber 2* 

180. 25 

26 
ThJs document describes the ifflPlement3tion^oJLJtkiS-Mli t ify 1 2 * 
on NOS 170. The reader should be aware that some of the 128 
parameters described below are machine dependent and will 29 
require adjustment when the final version of this utility is 38 
implemented to execute under NOS/VE. The most common examples 31 
of parameter information that will change is the length of 32 
user names and file names. Where possible the NOS 170 version 33 
will be made to emulate the final environment, 3^ 

35 
36 

2.1 £nj*£££IS 3? 

38 

This section introduces terms used throughout later 39 

sections of this document. *»8 

i*l 

hZ 
2.1.1 SOURCE LIBRARY *>3 

V* 

A source library is a file containing a collection of kS 

source decks. A source library will usually represent all or *f€ 

part of the source code for a product at a certain stage of %! 

development. V8 
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2.1.2 SOURCE DECK 

2.1.2 SOURCE DECK 1 

2 
A source deck is a physical collection of lines of source 3 
text. The text may consist of source code, documentat ion or *» 
any other type of source data. SCU text embedded directives 5 
may be intermixed with the source data. Each line of text 6 
will have associated with it a unique (with respect to the f 
deck) line identifier which can be used to identify the line. 8 
A line identifier consists of an alphanumeric modification 9 
name and a sequence number relative to that modification as it IS 
applies to a given deck. 11 

12 

13 
2.1.5 GROUP m 

15 
A group is a name associated with a collection of decks to 16 
allow for the logically related decks to be extracted from a 1? 
source library together or merely to document the fact that 118 
they are logically related. A deck may have up to 255 group 119 
names associated with it. 128 

21 

22 
2.1.^ MODIFICATION 23 

2% 
In this document the term modification will be used to mean 25 
the changes introduced to a deck or series of decks by an edit 28 
session. It is possible to have an edit session be considered 2? 
a continuation of a previous one. Each modification has 28 
associated with it a unique user assigned name. This name 29 
will be used to form the line identifier of each source line 38 
introduced by the modification. 31 

Modifications are stored on the source library by SCU in 32 
terms of their effect on the source decks to which they apply, 3$ 
rather than in the form of the original commands that 3% 
introduced the change. 35 

36 

3? 
2.1.5 FEATURE 38 

39 
A feature is a name associated with a modification. ^8 
Associating the same feature name with several modifications *fl 
to the same or different decks allows one the ability to group **2 
modifications together to be applied or Ignored as a group. <*3 
For example all the modifications necessary to make a malor *»5 
change in an interactive interface to the system could be kS 
associated with a common feature name. A modification may *»8 
have only one feature name associated with it. i+7 

hB 
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2.1,6 STATES 

2.1.6 STATES 1 

2 

Every modification has a specific state assigned to it. 3 

The state reflects the degree of maturity the modification has % 

attained. The following states are defined? 5 

6 

- Experimental Untested code. This implies that this f 

should probably not be included in a 8 

build by anyone except the person 9 

actually working on it or someone 18 

wanting to check for a potential 11 

conflict. 12 

II 

1 - Developmental Code which has been unit tested. 1% 

15 

2 - Stable Code which has passed regression tests* 16 

17 

3 - Verified Code which has been found to perform as IB 

advertised. 19 

2B 
h - Released Code which has been completely tested 21 

end approved. 22 

2S 

A modification in state may have its text or descriptive 2% 

information altered. Also if the user has t^ro^er authority* 25 

he can raise the state of a state modification. 26 

27 

Modifications in states 1* 2 or 3 may only be raised in 28 

state or lowered to state 0. No alteration of text or 29 

descriptive information is allowed for modif icaf ions in these 30 

states. 31 

32 

A modification in state t* cannot be altered in text* 33 

description or state. In other words* errors in text lines 3% 

introduced by a state h modification must be corrected under 35 

another modification name. 36 

3? 
38 

2.1.7 AUTHORITY 39 

In this document the term authority will be used to mean a kl 

user name that is validated by SCU to perform certain hZ 

manipulations on a source librbary. A source library has *»3 

associated with it a specification of each of four authorities *** 

necessary to change the state of a modification. The hS 

authorities specified are for 1 - Developmental* 2 - Stable* 3 t+% 

- Verified and ** - Released. Each modification has a k? 

specified state which may Include any of the above or - V8 
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2.1,7 AUTHORITY 

Experimental. A user must have the specified authority for a t 
library Cor a higher one} to raise the state of a modification 2 
to a given level or to lower it from that state to state 0. ! 3 

% 
5 

2.1.8 CRITERIA FILE 6 

7 
A criteria file contains directives used to limit which 8 
features and modifications at which states are to foe included 9 
when blocks of source data are expanded from a source 10 
library. Similarly decks or groups may be Included or 11 
excluded through directives on a criteria file. In addition 12 
values may be declared in a criteria file which can be used to II 
trigger conditional inclusion of blocks of source data when m 
decks are extracted from a source I ibrary and expanded for a IS 
processor. 16 

IP 
IS 

2.1.9 TEXT EMBEODED DIRECTIVES 119 

29 
When a user wishes to prepare source data for a processor, 21 
SCU will expand the source under the control of text embedded 22 
directives some of which interact with the contents of a 21 
criteria file. Text embedded directives are intermixed with 2% 
the source data. Text embedded directives are recognized as 25 
distinct from source data by the occurrence of a specific 2S 
character in the first post ion on the line followed 12? 
immediately by a keyword. In this document asterisk is shown 128 
as the key character in all examples. Some examples of text 329 
embedded directives are *C0PY and *ELSE. 130 

31 
32 

2.1.10 NORMAL SEARCH ORDER 33 

3** 

Some SCU commands working with decks allow the use of 35 

multiple source libraries. In locating a deck* the source 36 

libraries are searched in the order in which they are given in 3? 

the list. 38 

39 
k% 

2.1.11 BASIC STATUS CONCEPTS <*f 

k2 

System Command Language (SCL) under NOS/VE will require all *f3 

commands to have a status parameter. This parameter will be VS 

used to try to standardize the processing of error messages M5 

and abnormal responses from command processors. In the 1^6 

version of this utility which is implemented to execute under IVF 

NOS on CYBER 17 systems the value of this parameter must be **k9 
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2.1*11 BASIC STATUS CONCEPTS 

given as the nate of one of the fob control regeisters* Rl* 1 1 
R2* R3 or EF. The named register will be set non-zero i f an 12 
error is encountered while processing a command. If Rl, R2 or I S 
R3 is given* the value entered into the register will % % 
correspond to the condition codes shown in the section on % 5 
messages. I 6 

7 
8 
9 

2.1.12 NAMES 18 

II 
Names used in SCU will follow the NOS/VE patterns. Valid 12 
characters to be included in a name are upper and lower case 13 
letters, the characters "*#"♦ **$*% "a~ and "_** (underline) and i*» 
decimal digits. Names must not begin with a digit. Library 15 
names* deck names* feature names and group names will contain 16 
1 to 31 characters. The only exceptions to the pattern will 1? 
be modification names which will be restricted to a maximum of 18 
9 characters in length* Modification sequence numbers wilt be 19 
6 digits long and range from 1 to 2621^3. 2® 

21 
22 

2.1.13 STRINGS 123 

2«* 

Some parameters for the SCU commands are described as being 125 

strings. System Command Language syntax requires strings to 126 

be enclosed in single quotes. 12? 

28 

29 
2.1.1^ LOCAL FILES 31 

31 
SCU assumes all files it is to deal with are local with the 132 
exception of those named on the BASE and RESULT parameters 133 
below. The user may specify the user name for permanent I 3$ 
files* if different than his own* by including it as the 135 

second value in a value set. It is the user's responsibility 13© 
to acquire access to other files prior to initiating SCU 137 
commands to use them. 5 38 

The NOS 170 version of SCU uses a series of scratch files 139 
internally whose names begin with the string "SESSC*. The H*0 
user of the NOS 170 version should avoid making explicit use iht 
of files with names fitting this pattern. I*»2 

h% 
V7 
<t8 
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3.0 COMMANDS I 

2 

3 

% 

5 

6 

The commands listed below are available in the SCO 7- 

environment. Commands for the editor* text embedded § 

directives and criteria file directives are described later. 9 

The commands listed here function as separate job control 110 

statements and are intended to use a syntax as similar as Jit 

possible to that of the System Command Language ISCL) for 112 

N0S/VE. Hhep qtccessqd l Qn l NQ$_JXl* these cpfmantis must fc£ 1 1 3 

Prefjtxsfl kx l£l? .characters, "scmV',* The commands can also be \XH 

bound together in a more intimate fashion as described beta** 115 
under command grouping* 16 

If 
Parameter defaults are assigned as follows. Required IS 
parameters where possible will have static defaults assigned 19 
initially such as B*SE for the name of the base source 28 
library. The commands listed here are presented in a manner 21 
so as to emphasize the parameters of the commands. Optional 22 
parameters are enclosed with square brackets. As with NCS/VE 23 
SCL commands* commas and/or spaces can be used to separate Z% 
parameters. Parameters can be given posit ional ly t by 25 
keyword=vai ue or a mixture. In the fatter case specification 28 
of a parameter by keyword *"resets" the positional pointer to 2? 
the following parameter field. Where available, shortened 28 
forms for the keywords are shown. An ellipsis (two or more 29 
periods) at the end of a line indicate that the command is S3i 
being continued on the next line. Q& N QS 170 f o wer c ase 131 

tatters aaaaarjug in strings <m..tk&-~£irst pftysjcaj nne af , 3n * 38 

5CU c.offifflan.g; wjlj be capitalized? To., avoid—this unpjeqsant 133 

5iQ> ^ff^ct of ejsecytJLug on ,,NQS UQ fl ,M5er^houJ.jLJ.aglyde. 1 3 h 

strings. .WMcti.^re parameters to ,,,,^CU_oii,cg^tiQ^tlacu.ljLnigs A _ 1 3 5 

36 

As on NOS/VE all lower case letters appearing inside names 3? 

(and references to nsmes) are translated to their upper case 33 

counterparts by the SCL interpreter. 39 

^0 

Hi 

The short form of each command Is listed with the command. kZ 

<f! 
<*% 
k$ 
^6 
<♦? 
V8 
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3.1 SOURCE LIBRARIES 
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3.1 SOUR CE LIBRARIES 1 

2 

The following commands are available for creatine and 9 

manipulating source lifcraries. % 

5 

6 

? 

3.1.1 CR£ATE_LIBRARY \ CRL 8 

9 
IS 
This command creates the header of a source library on the 11 
specified file and includes in this header the descriptive 12 
information about the library including the library name, key 13 
character for text embedded directives and user names to be \% 
assigned authorities. 15 

16 
create_l ibrary Cname=< I ibrary_name>3 1? 

tdescr iption=<descript ive_string> J 18 

C author it y_l=<user_name>1 19 

lauthority_2=<user_nafne>3 2D 

t author ity_3=<user_name> 3 21 

tauthority_**=<user_name>3 22 

tkey=<char>3 23 

tversion=<version_string>3 2% 

tresul t =<f ile_name>3 3 25 

tstatus=rllr2lr3lef 3 126 

Zf 
name I na s This specifies the name of the source 28 
library. If this parameter is omitted the name of the 29 
result file will be used. 30 

31 
description 3 de s This 1 to 256 character string is used 32 
to describe the source code maintained on this library. 33 

3*» 
authority_l l al : This is the 7 character user name to 35 
have authority 1 (developmental authority) for this 36 
library. If parameters authority_I through authority^ 31 
are not given* the user name that the command is 38 
executing under will be used. 39 

<i9 
author ity_2 I a2 * This is the 7 character user name to hi 
have authority 2 (stable authority) for this library. <»2 

**3 
author ity_3 S a3 i This is the 7 character user name to *♦$ 
have authority 3 (verified authority) over this library. **5 

<*6 
author I ty_4 5 ak s This is the 7 character user name to hi 
have authority k (released authority) for this library. i»8 

COMPANY PRIVATE 



3-3 
CDC SOFTWARE ENGINEERING SYSTEM 

03/2«»/8G 
ERS for Source Code Utility <NOS 170 Version) REV* J 

3,0 COMMANDS 

3.1.1 CREATE_LI8RARY 1 CRL 



key 1 k s This one character string specifies the key 2 
character used to flag text embedded directives on this 3 
source library. This defaults to *. % 

5 
version J ve s This 1 to 31 character string is used to ? 6 
give a version nuiber for the library. % ■? 

8 
result ? r 3 This is the name of the file on which the % 9 

source library is to be created* RESULT is used as a !1S 
default value. 11 

12 
status I st s See basic status concept. 13 

1* 
Examples* 215 

scu.create_l ibrary scu_source_code *Neat stuff." a%=m|p2523 .. 116 
r^scupl 1? 

118 
SCU.CRL Table_Tennis_League_Records 119 

28 
In the first example the library name and description 121 
parameters are given positionally and the authority,, i* and 122 
result fife names are given with the keyword = value syntax. 129 
The remaining authorities would default to the user name the 2* 
command was executed under and * would be used to flag text 25 
embedded directives. 26 

In the second example only the library name is civen 12? 
explicitly and a source library will be created on the file 128 
RESULT. 129 

38 
31 
32 
33 
3* 
35 
36 
31 
38 
39 
<»8 
VI 
t*Z 
i»3 
*f* 
*»5 
i*% 
<♦? 

COMPANY PRIVATE 



3-ft 

CDC SOFTWARE ENGINEERING SYSTEM 

03/2ft/8D 
ERS for Source Code Utility <NOS 170 Version) REVSJ 

3.0 COMMANDS 

3.1*2 OISPLAY_LIBRARY I OIL 

3.1.2 DISPLAY.LIBRARY ! OIL 1 

2 

This command lists the descriptive information stored in 3 

the source library header and optionally the contents of deck* ft 

group* modification and feature lists for the library. 5 

6 
display__l ibrary I base=<f i le_name> 1 % ? 

I list=<l ocal_f i le_name>] J 8 

tbrief I ful U 3 9 

tstatus=rl?r23r3ieU 319 

11 
base I ba s This is the name of the file containing the 112 
base source library. If this parameter is not given an 113 
attempt is made to access a file with the name BASE. lift 

15 
list % I s This is the name of the file which receives 16 
the listing. If this parameter is not given* the file 17 
name OUTPUT will be used. 1* 

19 
brief ? br i full J fu s If the command contains the 28 
keyword BRIEF* only the information from the library 21 
header will be displayed. If the keyword FULL is 22 
present* the deck* group* modification and feature lists 23 
for the library will be displayed as well. If neither is 2ft 
present BRIEF is assumed. 25 

26 
status 3 st * See basic status concept. 2? 

28 
Example? 129 

scu.disolay_l ibrary ba = oldpl 130 

31 

This command will display only the descriptive information 32 

from the library header of the source library on file OLDPL* 33 

The display will be written to the file OUTPUT. 3ft 

35 
36 
37 
38 
39 
ft® 
ftl 
ft2 
ft3 
ftft 
ft5 
ft6 
ft? 
ftS 
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J.G COMMANDS 

3,1,3 CHANGED I3RARY I CHL 



3.1.3 CHANGE_LIBRARY 1 CHL 

This command allows a user to alter fields in the library 
description. 

change^.! ibrary tname=<l ibrary_name>l 

Cdescr iotion=<descript ive_string>l 
C author ity_I=<user_name>l 
t author it y_2=<user_name>l 
t author it y_3=<user_n awe >] 
Cauthority_4=<user_name> 1 
£version=<version_string>l 
Cbase=<f 1 le_name>1 
Cresul t~<f i le_narae>1 
Cstatus=rllr2lr3lef 1 

name I na 8 This specifies the name of the source 
library. 

description 1 de s This 1 to 256 character string is used 
to describe the source code maintained on this library. 

author ity_l 1 al s This is the 7 character user name to 
have authority 1 for this library. In order to alter 
fields authority_i through author! ty_*M this command must 
be executed under the user name that has the 
corresponding authority or a higher one. 

authority_2 I a2 8 This is the 7 character user name to 
have authority 2 over this library. 

author ity_3 3 a3 5 This Is the 7 character .user name to 
have authority 3 over this library. 

author ity_J» 3 a*> * This is the 7 character user name to 
have authority h for this library. 

version I ve * This i to 31 character string is used to 
give a version number for the source library. 

base I ba s This is the name of the file containing the 
base source library. If this parameter is not given an 
attempt is made to access a file with the name BASE. 

result S r * This is the file to receive the altered 
library. If this parameter is not given? it will be 
written to a file named RESULT. 



5 
6 
f 

8 

9 

10 

11 

12 

tlS 

31* 

115 

16 

17 

18 

19 

28 

21 

22 

23 

2*i 

25 

26 

27 

28 

29 

39 

31 

32 

33 

3i» 

35 

36 

37 

138 

139 

*fG 

S41 

5<*2 

1<f3 

hh 

\kB 

J*t6 

3<*7 
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3,0 C0HMAN9S 

3.1*3 CHANGE_LI8RARY 5 CHL 

status i st : See basic status concept. ! 1 

2 
Examples 1 3 

scu.change_1 ibrary vers! on=" 1.0* ba=mylib 1 $ 

5 
6 
? 

a 

9 
10 
11 
12 
11 
1% 
15 
IS 
if 
18 
19 
28 
21 
22 
2S 
2* 
25 
26 
2f 
28 
29 
38 
31 
32 
33 
3* 
35 
36 
3? 
38 
39 
<+Q 
*♦! 
**2 
<»3 

t*S 
kb 
k7 
hB 
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3.0 COMMANDS 

3.1. <♦ C0M8INE_LI8RARY I COL 

3.1.^ COM8INE_LI8RARY t COL I 

2 

This command merges the decks from a list of source 3 

libraries into a single result library. The result library 5 

will include one deck by every name encountered on any of the 5 

source libraries. If decks by the same name occur on more 6 

than one library the deck from the library listed first will ? 

be selected. Decks will have the following logical order on 8 

the result library? 9 

18 

1. All decks with names occurring on the last named 111 
source library will occur first in their original 312 
order. 513 

1% 

2. Next the decks with names occurring on the next to 115 
last named library will occur in the order they 116 
occurred on that library. SI? 

IS 

3. Decks with names occurring on the remaining libraries 119 
will occur in turn in the order they occurred on 120 
those libraries. 121 

22 

All source libraries must have the same key character. The 123 

result source library will have the same authorities* 12k 

description* etc. as the last named source library. This 525 

command will indicate an error if there are any Interlock 526 

violations (see discussion of interlock under 127 

EXTRACT_LIBRARY| . 128 

29 

combine_l ibrary base=<f i le_name> 138 

tresuf t=<f i!e_name>1 131 

C list=<iocal_f i le_name>] S32 

Ibrief 1 ful I 1 133 

£status~rllr2Sr3ief 1 13% 

35 

base I ba 5 This is a list of names of files containing 136 

source libraries to be combined. The names must be 13? 

enclosed in parentheses and separated by commas. 138 

39 

result \ r t This is the file to receive the combined 1%8 

source library. If this parameter is not given* the 1V1 

combined source library will be written to a file named !**2 

RESULT. 5<f3 

list I 1 s This is the name of the file which receives l%5 

the listing. The list shows from which source library 14*6 

decks on the result file were taken. If this parameter !%? 

is not given* the file name OUTPUT will be used. ?%8 
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3.0 COMMANDS 

3.1.4 COMBINELIBRARY 3 COL 



brief 1 br 1 f ul I 5 fu s These keywords can be used to 
select a shorter cr more detailed listing. Currently 
both listings are the same. 



status 



st 



See basic status concept. 



Example? 

scu.combine^l Ibrary (changed*new*base> newbase 

In this example two source libraries on files named CHANGED 
and NEW were combined with one on a file called BASE to form a 
result on a file named NEWBASE. To illustrate how decks are 
selected and ordered during the processing of this command 
(and give an example of how this command is intended to be 
used! let us assume that the three libraries being combined 
each contained the fol lowing decks* 



£MM££EL. 

CURT 

JIM 

HIKE 

B08 



N£fr 

SHARON 

ED 



ftftSE_ 

JIM 

BOB 

MIKE 

BILL 

SHERMAN 

CURT 

JOHN 

HARVEY 



N£W§MJL 

JIM 

BOB 

MIKE 

8ILL 

SHERMAN 

CURT 

JOHN 

HARVEY 

SHARON 

ED 



CHANGED 

CHANGED 

CHANGED 

BASE 

BASE 

CHANGED 

BASE 

BASE 

NEW 

NEW 



.From, 



In the example above the file named CHA 
also occurred on the file named BASE, 
rather than their duplicates from BASE* b 
NEWBASE in the same relative position as 
The decks from NEW which were not duplicat 
end of the deck sequence from BASE in the 
on NEW. Likewise had there been any decks 
unique names they would have been added at 
sequence on NEWBASE. 

In the example above files CHANGED and 
the same name. Had deck 808 also occurred 
BOB from CHANGED would still have been sel 
the same position on NEWBASE. Had deck 
on CHANGEO the copy from CHANGED woul d hav 
it would have been placed in the same posi 
example. 



NGEO ha 
These 

ut wer 
their 

ed were 
order 
on CHA 
the en 



d decks 
were se 
e plac 
counter 

added 
they oc 
NGEO th 
d of th 



that 
I ected 
ed on 
parts, 
at the 
curred 
at had 
e deck 



NEW had no decks by 
on NEW* the copy of 
ected and placed in 
SHARON also occurred 
e been selected and 
tion as shown in the 



1 

I 2 

! 3 

I * 

5 

1 6 

7 

1 8 

5 9 

10 

11 

12 

13 

1% 

15 

16 

II 

19 

19 

23 

21 

2a 

23 

2% 

25 

26 

2? 

28 

29 

38 

3i 

32 

31 

3* 

35 

36 

31 

138 

5 39 

\h% 

?<ft 

\**Z 

U3 

!^5 

\hS 

*<t« 

hi 

<t8 
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3*0 CQNMANDS 

3.1.5 AOO LIBRARY 1 AOL 



3.1.5 A0D_LI8RARY I AOL 

This command merges the decks from a list of source 
libraries into a single result library. The result library 
will include one deck by every name encountered on any of the 
source libraries. If decks by the same name occur on more 
than one of the libraries these decks will not be written on 
the result library and the duplication will be reported in the 
listing. Decks will have the following logical order on the 
result library* 

1. All decks occurring on the last named source library 
will occur first in their original order. 

2. Next the decks occurring on the next to last named 
library will occur in the order they occurred on that 
1 ibrary. 

3. Oecks occurring en the remaining libraries will occur 
in turn in the order they occurred on those 
i ibraries. 

All source libraries must have the same key character. The 
result . source library will have the same authorities* 
description, etc. as the last named source library. 

add_J ibrary base=<f i le_name> 

fresul t=<f 1 le_name>3 
t 1 lst=<local_f ile_name>1 
tbrief I full] 
Cstatus=rllr21r3ief 1 

base 1 ba s This is a list of names of files containing 
source 1 ibraries to be combined. The names must be 
enclosed in parentheses and separated by commas. 

result 1 r : This is the file to receive the combined 
source library. If this parameter is not given, the 
combined source library will be written to a file named 
RESULT. 

list 1 1 s This is the name of the file which receives 
the listing. The list shows from which source library 
decks on the result file were taken. If this parameter 
is not given, the file name OUTPUT will be used. 

brief ! br 1 full 1 fu t These keywords can be used to 
select a shorter or more detailed listing. Currently 



1 
2 
3 
% 
5 



1 6 
I 7 
t 8 
I 9 
110 

11 
112 
113 

1% 
US 
116 
117 

18 
119 
129 
S21 

22 
?2§ 
12% 
*25 

28 
12? 
128 
129 
139 
131 

32 
131 
*3* 
135 

36 
13? 
138 
139 
!<*0 

<a 

\hZ 
1^3 
IM» 

1^5 

l*f? 
1M* 
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3.0 COMMANDS 

3.1.5 ADO_LIBRARY ? AOL 



both listings are the same. 

status I st i See basic status concept. 

Examples 

scu»add_l ibrary f green*new t basel newbase 

In this example the decks on the libraries on the files 
named GREEN and NEW are added to those on the library on file 
base to form a result on a file named NEWBASE* To illustrate 
how decks are selected and ordered during the processing of 
this command let us assume the three libraries being combined 
each contained the fol lowing decks: 



1 1 
2 



GREEN 


NEW 


PA$£ 


NEWBASE 


Sesfc-Iahsfl-fEfliB 


FRED 


SHARON 


JIM 


JIM 


BASE 


GORDY 


ED 


8GB 


BOB 


BASE 


AL 




MIKE 


MIKE 


BASE 


JUOY 




BILL 


BILL 


BASE 






SHERMAN 


SHERMAN 


BASE 






CURT 


CURT 


BASE 






JOHN 


JOHN 


BASE 






HARVEY 


HARVEY 

SHARON 

ED 

FRED 

GORDY 

AL 

JUOY 


BASE 
NEW 
NEW 
GREEN 

GREEN 
GREEN 
GREEN 



In the example above there were no deck names duplicated on 
the three libraries. On the file NEWBASE the decks from BASE 
occur first in their original order followed by the decks from 
NEW and GREEN. 

Had any deck names been duplicated* none of the duplicates 



would have been 
been informed. 



written to NEWBASE and the user would have 



% 

5 



I 



I 8 
I 9 

lie 
in 

112 
513 

lh 
115 
116 
II? 
118 
119 
128 
121 
122 
123 
12% 
125 
126 
12? 
128 
129 

39 
I3f 

133 

134 

135 

136 

I3f 

38 

39 

k% 

kt 

t*2 

<t3 

kS 
<f6 
kW 
<♦« 
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3.0 COMMANDS 

3.1.6 REPLACE_LIBRARY I REL 

3.1.6 REPLACE_LIBRARY I REL 5 1 

2 
This command merges the decks from a list of source 1 3 
libraries into a single result library. The result library I ** 
will include one deck by every name encountered on the last I $ 
named source library. If decks by the same name occur on more i 6 
than one library the deck from the library listed first will IF 
be selected. Decks with names that do not occur on the last I 8 
named library will not be included in the result library and I 9 
that fact will be reflected in the listing. Decks will have 110 
the following logical order on the result library* 111 

12 

1. All decks with names occurring on the last named 113 

source library will appear in their original order* 11$ 

IS 
All source libraries must have the same key character. The 116 
result source library will have the same authorities* 11? 
description, etc. as the last named source library. This 118 
command will be indicate an error i f there are any interlock 119 
violations (see discussion of interlock under 120 
EXTRACT_LIBRARY) . 121 

22 
repl ace_l ibrary base=<f i le_jrame> 123 

tresul t=<file_narae>J I2€ 

€ list=<l ocal_f i le_name> J 325 

tbrlef 1 fulU 126 

istatus=rllr21r35ef 1 527 

28 
base I ba s This is a list of names of files containing 129 
source libraries to be combined. The names must be 138 
enclosed in parentheses and separated by commas* 131 

32 
result 1 r 5 This is the file to receive the combined 133 
source library* If this parameter is not given* the 13* 
combined source library will be written to a file named 135 
RESULT. 136 

31 
list 1 1 t This is the name of the file which receives 538 
the listing. The list shows from which source library 139 
decks on the result file were taken* If this parameter i*>0 
is not given, the file name OUTPUT will be used. 1VI 

k2 
brief I br I full I fu 5 These keywords can be used to Ifc3 
select a shorter or more detailed listing. Currently lh** 
both listings are the same. !*»5 

t*6 
status 1 st s See basic status concept. !**? 

h% 
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3.0 COMMANDS 

3.1.6 REPLACED IBRARY I REL 



Example? 

scu.repl ace_l ibrary 



Cchanged* new* base) newbase 



In this example two source libraries on files named CHANGED 
and NEW were combined with one on a file called BASE to form a 
result on a file named NEWBASE. To illustrate how decks are 
selected and ordered during the processing of this command* 
let us assume that the three libraries being combined each 
contained the f ol lowing decks* 



CHANGED 


NEW 


BASE 


N£W8AS£ 


Pff€f5,.„X§foifl! „ f C°ffi 


CURT 


SILL 


JIM 


JIM 


CHANGED 


JIM 


HARVEY 


BC8 


808 


CHANGED 


MIKE 




MIKE 


MIKE 


CHANGED 


808 




8 ILL 


BILL 


NEW 






SHERMAN 


SHERMAN 


BASE 






CURT 


CURT 


CHANGED 






JOHN 


JOHN 


BASE 






HARVEY 


HARVEY 


NEW 



In the example above the files named 
decks that also occurred on the file named 
selected rather than their duplicates 
placed on NEWBASE in the same relative 
counterparts. 

Had there been decks on CHANGEO or NEW 
on BASE* they would not have been written 
user would have been informed. 



CHANGED and NEW had 
BASE. These were 
from BASE* but were 
position as their 

that did not appear 

to NEWBASE and the 



I 2 
3 

I « 
i S 
1 6 
1 F 

i a 

! 9 
IS 

lit 

112 
113 

\m 
us 

316 

117 

119 

519 

2% 

121 

122 

123 

12* 

125 

126 

?2t 

5 28 

29 

3® 

31 

32 

33 

35 

35 

36 

3? 

38 

39 

<f# 

i*l 

k2 

hS 
**$ 
*>? 
**% 
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3,0 CGNMANOS 

3.1,7 EXTRACT_LI8RARY 1 EXL 

3.1.7 EXTRACT_LI8RARY I EXL 1 

2 

This command is used to isolate a source library with only 3 

a subset of decks on i t for manipulation by the SCU editor or % 

maintenance as a separate source library. If the INTERLOCK 5 

option is used* the user must have write access to the file 6 

named with the BASE parameter. ? 

9 

extract_l ibrary tname=<deck_name>lall 1 9 

£criteria=<local_f i le_name>1 1§ 

i inter lock=<user_name> % no_inter lock! If 

tbase=<f ile_name>l 112 

Cresul t=<f ile_name>1 113 

Cstatus=rllr2lr3ief J 11% 

15 

name I na I all s This is the name of a deck to be 16 

extracted. Alternatively a list of names separated by 1? 

commas and enclosed by parentheses may be given or a 18 

range of decks may be indicated by giving the first and 19 

last deck names to extract separated by ellipses. Use of 20 

the alternate keyword ALL to specify this parameter has 21 

the same effect as specifying the first and last decks as 2t 

a range. If this parameter is omitted* the contents of 23 

the source library to be extracted will be determined 2* 

solely by the contents of the criteria file. 25 

26 

criteria 3 cr s This names a file which can be used to 2? 

further define which source data is to be included on the 28 

subset source library, 29 

38 

interlock I int I no_interlock I nint s This parameter 31 

provides a means to allow only the people authorized to 31 

use a particular user name to alter the decks being 35 

written to the subset library. The value of the 3* 

parameter may be given as a user name or if the keyword 35 

INTERLOCK only is given the user name the command is 3ft 

executed under will be used. When a deck is inter! ocked* 3? 

an attempt to extract it to a subset library setting th^ 138 

interlock will be rejected. Also an attempt to replace 139 

the deck on a source library by doing a C0MBINE__LI8RARY 1^8 

or REPLACE_L IBRARY with the base will be refected* unless I VI 

its from the subset library with the interlock set. If 5%2 

the command includes the N0_INTERL0CK keyword the user 1^3 

will be allowed to extract a subset source library l*»S 

whether or not the decks he requests are interlocked. An l<»5 

attempt to interlock decks with this command will be 8«*S 

rejected if the criteria file contains directives which l*>? 

cause modifications to be excluded. If neither keyword l**8 
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3,0 COMMANDS 

3.1.7 EXTRACT_LI8RARY 1 EXL 

is present, the command is processed as if NG_INTERLOC^ i t 
had been specified. 2 

3 
base I ba 8 This is the name of the file containing the J % 
base source library. If this parameter is not given an 1 5 
attempt is made to access a file with the name BASE. 1 6 

? 
result I r s This is the file to receive the subset 8 
source library. If this parameter is not given, the 9 
subset source library will be written to a file named IB 
RESULT. 11 

12 
status 1 st s See basic status concept. 13 

1*» 
Examples IIS 

scu.extract_ I ibrary dsd int=l ohndoe r=temppl 116 

17 
In this example a subset library is extracted from the 18 

source library on the file named BASE which includes only the 19 
deck dsd. This subset source library is written to a file 28 
named TEMPPL and the deck dsd is interlocked for user name 21 
JOHNDOE. 22 

23 
2* 
25 
26 
2? 
28 
29 
3 9 
3i 
32 
33 
3* 
35 
3€ 
3? 
38 
39 
*f0 

hZ 
1*3 
t*h 

hS 

<*8 
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3.0 COMMANDS 
3.2 SOURCE DECKS 

3.2 SOURCE DECKS 1 

2 

These commands are available for creating and manipulating 3 

source decks. 5 

5 

6 

3.2.1 CREATE^DECK 5 CRD 7 

6 

This command is used to create source deck(s). 9 

If 

create_deck name= C <<deck_name>C,<loca l_f i 1 e_name>1) * • ••) I III 

names_on_ f i le=<local_f i le_name> 112 

modi f icat i on=<mod i f icat ion_name> 13 

t a f ter=<deck_name > I be f ore=<deck_name> I a I phabe t ic 1 J 15 

f author=<author_name_string> 1 l 15 

tdescript ion=<deck_descript ion_string>I 116 

{processor =<processor_name_string>l Si? 

tgroup=<group_name> 1 516 

(tab=<tab_character>lnotab J 119 

tcolumns=<tab_column_integers>l 526 

twldth=<integer>J 5 21 

CI id-<l ine_identi f ier_placement_keyword>l 122 

tbase=<f i I e_name>l 3 23 

tresult~<f ile_name>) 525 

£ expand I no_expandl 125 

Iroul t i_parti tion J single_part itionl 5 28 

tsame_as=<deck_name>l 2? 

£status=rilr21r31efi 126 

29 

name 5 na I name «_on_f i le I nof : This parameter must be J 36 

given in one of the two forms shown below. If the NAME 531 

or NA keyword is used *or no keyword is given), the 132 

required portion of this parameter is a 1 to 31 character 133 

deck name. It may optionally be followed by the name of 3% 

a local file containing source data to be included in the 35 

deck as text. Alternatively a list of deck names or deck 36 

names and file names may be given (see the Parameter 3? 

Lists section of the NOS/VE ERS). All decks created with 536 

a single CR£ATE_OECK command will have Identical 139 

descriptive information taken from the other parameters 156 

on this command. An attempt to create a deck with the 51 

same name as one already on the base source library will" 152 

be rejected. If the keyword NAMES_ON_FILE or NOF is 55$ 

used* this parameter names a file from which initial text 155 

for decks will be read. Deck names will be taken from 155 

*DECK text embedded directives intermixed with the 156 

initial text. 55? 

56 
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3.Q COMMANDS 

3.2,1 CREATE.DECK 3 CRD 



modification I mod 5 This 1 to 9 character modification 1 
name will be associated with the creation of this deck 3 1 
and included as part of the line identifier for all I 3 
initial lines of text if any are introduced with this I 5 
command. I 5 

6 
after I af I before I be 1 alphabetic I alpha 9 This ? 
parameter can be used to name a deck on the library after 8 
or before which this deck will be added. If the keywords 9 
AFTER or BEFORE are used alone, the deck will be added at 10 
the end or beginning of the the deck sequence 11 
respectively. Alternatively the ALPHABETIC keyword may 12 
be used to indicate that the deck will be added in 13 
alphabetic sequence. If this parameter is omitted the 15 
deck will be addec in alphabetic seouence. 15 

16 
author S au * This 1 to 31 character string is provided 11? 
to identify the person who wrote this unit of source 118 
data. 119 

28 
description 1 de s This I to 256 character string is used 121 
to describe this ceck. 122 

23 
processor I p t This 1 to 31 character string is used to 25 
identify the processor that will use the source data in 25 
this deck as input. 26 

27 
group 3 g s This is a 1 to 31 character group name to be 28 
associated with this deck. Alternatively a list of group 29 
names may be given separated by commas and enclosed in 30 
parentheses. 31 

32 
tab I notab s If the TAB keyword is used or this 133 
parameter is given positionally* this one character 135 
string specifies a default tab character for use when 135 
editing this deck. If the N0TA9 keyword is given tabbing 136 
will be deselected by default for this deck. S3? 

38 
columns I col s These integers between 1 and 256 are the 139 
default tab stops when editing this deck. A series of 150 
tab columns may be specified as a value list (see the 151 
Parameter lists section of the NOS/VE ERSI . A maximum of 352 
256 tab columns may be specified. 153 

55 
width I w ? This is the default line width to be used 355 
when this deck is expanded and to be used by the SCtt 156 
editor. The value must be given as an integer between 35! 
and 256. Specifying as a width selects the defaults of 358 
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3*0 COMMANDS 

3. 2, I CREATE DECK J CRO 



supplying no trailing blanks when this deck is expanded 
and allowing lines up to 256 characters to be entered 
with the editor* If this parameter is not given a 
default value of will be used* 

lid s This parameter is the default line identifier 

placement when this deck is expanded* If this parameter 

is omitted the expanded text file will contain no line 

identifiers* This parameter can be given as one of 3 
values* 

right i tine identifiers will be placed on the 
right. 

left i Line identifiers will be placed on the left* 

none * Output lines will contain expanded text 
only* 



base I ba ? This is the name of the file containing the 
base source library to which the new decks are to be 
added. If this parameter is omitted an attempt is made 
to access a file named BASE* 



result 3 r s 
source I ibrary* 
modified source 
RESULT* 



This is thQ file to receive 

If this parameter is not 

library will be written to 



the modified 

given* the 

a file named 



expand I exp I no_expand 8 nexQ s If the 
keyword is included on this command these decks 
be written to the expanded text file produce 
EXPANO_DECK command as a result of processin 
embedded directives *C0PY and *COPYC. If t 
keyword is included or this parameter i 
entire I y. these decks will be written to the 
text file by the EXPAND_DECK command whether na 
command or on *C0PY and *COPYC directives* 



N0_EXPAND 
will on I y 
d by the 
g the text 
he EXPAND 
s omitted 
expanded 
med on the 



mul ti_partit ion I mp I single_partition I sp 3 If the 
MULTI_PARTITION keyword is included on the command* each 
end of record encountered in the source file will be 
represented on the source library as a *WE0P text 
embedded directive. If the SINGLE_PARTITION keyword is 
used or this parameter is omitted entirely* only the text 
before the first separator on the source file will be 
represented on the source library. 



1 

2 

3 

$ 

5 

6 

7 

8 

I 9 

US 

It 

112 

113 

I** 

115 

16 

117 

118 

19 



121 

322 

123 

12% 

25 

126 

127 

128 

129 

38 

131 

S32 

133 

13% 

135 

136 

537 

138 

139 

f»8 

Ul 

i*f 2 

1*>3 

145 

!*f5 

«♦€ 

kf 

k9 
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3,0 COMMANDS 

3.2.1 CREATE_DECK i CRD 

1 

saffle.as I sa s This specifies the naie of a deck on the 1 
base library. Values from that deck's header will be 3 
used to supply values not given explicitly on this I % 
command for the author* description* processor* group* t 5 
tab* columns* width* lid* and expand/no_expand I 6 
parameters* I f 

8 
status I st s See basic status concept, ! 9 

IS 
Example is 111 

112 
scu.create_deck . . 113 

naie= ( (amp$get_direct*srcf i le) ) •• 1$ 

modi f ication=original .. 15 

author=*R. D. Palm* •• 18 

description=*Get Direct module.' • • lif 

processor^ CYBIL/CI - . • 118 

group=f i le_io • * 19 

same_as=f i I e_io_prototype 28 

21 
22 
In this example* a new deck named amp$get_direct is added 123 
to the source library on file 8ASE. The enlarged library is %Zh 
written on the file RESULT. The initial text for the deck is 525 
read from file SRCFILE and each line will have the 26 
modification name original associated with it. The author* 2? 
description* processor and grouo parameters were given 28 
explicitly on the command. Values for ihe remaining 29 
parameters will be copied from the description of the deck 30 
named f i le_lo_prototype. In this example the ability to use 31 
an ellipsis at the end of a line to continue a command was 32 
used to make the command more readable and possibly easier to 33 
maintain or modify should it be used as part of a procedure 3*» 
file. 35 

38 
Example 2: 3? 

538 
scu.crd William_Cody bill 139 

1^0 
In this example the deck WILLIAM_CODY is added to the H*l 
library on file BASE and the result is written to file \t*Z 
RESULT. The creation of the deck is associated with the i*»3 
modification name bill. No initial text is supplied for the **** 
deck (it may be added later with the editor) and default <»5 
values are supplied for all the other parameters. **6 

Example 3s -Ml 
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3.0 COMMANDS 

3.2,1 CREATE_DECK I CRO 

I 1 
scu.create_.deck . . 12 

(utv, (w, wf i ie) ,x, y,z) .. 3 

encrypto .. % 

author=*M. J. Perreten* *. I 5 

same_as=CY8IL_type_declaratlons 5 6 

? 
In this example decks u through z are added to the source 8 
library on file BASE. The enlarged library is written to the 9 
file RESULT. Deck w has initial text supplied from file 10 
HFILE. The modification and author fields are given 11 
explicitly on the command. Values for the remaining 12 
oarameters will be copied from the description of the deck 113 
named CYBIL_type_decl arations. ilk 

15 
Example M US 

ft? 
scu.create_.deck . . lit 

nof=august •• 119 

number 12 •• I2f 

author="Henry McGilton" .. 121 

description-^ August Tools Bulletin* 122 

123 
In this example text for some deck or decks is read from a 12** 
file named August which contains DECK text embedded 125 
directives. This deck will be added to those on the library 126 
on file BASE and the result written to a file named RESULT. 12? 
The modification name associated with each line in the new 128 
deck will be NUMBER12. Henry McGilton is identified as the 129 
author and the deck is described as containing the August 139 
Tools Bulletin. 131 

32 
33 
ZH 
35 
36 
31 
38 
39 
<tf 
hi 
h2 
*>3 
**% 
kS 
<*6 
h7 
<*8 
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3.0 COMMANDS 

3.2.2 DISPLAY_OECK ! OIO 

3,2.2 DISPLAY_OECK I OIO i 

2 

This conand displays descriptive information about the 3 

deck. h 

S 
display_deck name=<deck__name>?al I 6 

Cbase=<f i ie_name>1 J f 

I list=<local_f if e_name>l I 8 

Cbrief 5 fulU 8 9 

Cnotext 1 active I inactlvel 11$ 

Istatus=rl5r2lr3lefl lit 

12 
name I na I all s This is the name of a deck to be 13 
displayed. Alternatively a list of names separated by !«♦ 
commas and enclosed by parentheses may be given or a IS 
range of decks may be indicated by giving the first and 18 
last deck names to display separated by ellipses. Use of IF 
the alternate keyword ALL to specify this parameter has 1® 
the same effect as specifying the first and last decks as 19 
a range. 2fl 

21 
base I ba s This is the name of the file containing the 122 
base source library. If this parameter is not given an 121 
attempt is made to access a file with the name 8ASE. !2«* 

25 
list 1 I s This is the name of the file which receives 26 
the listing. If this parameter is not given* the file 2? 
name OUTPUT will be used. 28 

29 
brief S br 3 full 1 fu s If the BRIEF keyword is included 3® 
on this command* only the descriptive information from 34 
the deck header will be displayed. If the FULL keyword 32 
is used the list of modification names and group names 35 
associated with this deck will be displayed as well. 3% 
Omitting this parameter gives the brief display. 35 

36 
notext I active I act I inactive I inact s If the 13? 
INACTIVE keyword is included on this command both active 138 
and inactive lines from the deck will be displayed. If 139 
the keyword ACTIVE is given only the active lines in the !<tt! 
deck will be displayed. If the NONTEXT keyword Is given ikl 
or this parameter is omitted entirely none of the text ih2 
lines of the deck will be displayed. |J*3 

k% 
status I st s See basic status concept. IkS 

*f6 
Examples ?<♦? 

scu.display_deck dsd full !t»9 
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3.0 COMMANDS 

3.2.2 OISPLAY_DECK I DIO 



The command in this example lists the descriptive I 

information from the header of deck dsd from the source I 

library on file BASE as well as the list of modification and I 

group names associated with this deck. The text lines of the I 

deck are not included in the listing. The listing is written ! 

to the file called OUTPUT. I 



i 

2 
3 

H 
5 
6 
t 
8 

18 
II 
12 
13 
l*t 
15 
16 
17 
18 
19 
20 
21 
22 
23 
2* 
25 
26 
Zl 
28 
29 
3f 
31 
32 
31 
3** 
35 
36 
3? 
38 
39 
(*t 
t*t 
i*2 
fcf 

ws 

<*6 
*** 
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3,0 COMMANOS 

3.2.3 CHANGE_DE€K 1 CHO 

3.2.3 CHANSE_DECK 5 CHO i 

2 

This command is used to change fields in the deck 3 

description. h 

5 

change_deck name=<deck_name>i al I i 6 

tauthor=<author_name_string>l F 

t inter! ock-<user_name>] 8 

tdescription=<deck_descript ion_string>3 % 

tprocessor=<processor_name_str ing>l If 

£group=<group_narae> J 11 

I del ete_group=<group_name>l 12 

ttab=<tab_character>?notab3 513 

£coIumns=<tab_column_integers> J 1% 

Idelete_colunins=<tab_column_integers> I 15 

£width=<in teger>3 IS 

II id=<l ine_identi f ier_placement_keyword> 3 If 

£base=<f i I «_name>l ll# 

tresult=<f ile_name>l S19 

C expand 1 no_expand3 128 

£status=rllr2lr3Sef 3 $21 

22 

name 1 na 1 all s This is the name of a deck to have its I2S 

description altered. Alternatively a list of names 82*» 

separated by commas and enclosed by parentheses may be 125 

given or a range of decks may be indicated by giving the 126 

first and last deck names separated by ellipses. Use of 12? 

the alternate keyword ALL to specify this parameter has I2S 

the same effect as soecifying the first and last decks as 129 

a range. 139 

31 

author 3 au * This 1 to 31 character string Is provided 3 32 

to identify the person who wrote this unit of source 13$ 

data. 13% 

35 

interlock I int 5 This parameter is included to allow the 36 

interlock for a deck (see the EXTRACT_LIBRARY command) to 3* 

be changed or cleared. It is altered by supplying a new 38 

user name as the value for this parameter and it is 39 

cleared by supplying the keyword INTERLOCK only. *»9 

Altering this field is restricted to the user name which hi 

has authority k for this library. Clearing this field is h2 

restricted to the user name which has authority k f or the %3 

library or the user name for which the interlock is set. %% 

hS 

description I de * This 1 to 256 character string is used %k& 

to describe the contents of this deck. t*»? 

%« 
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3,0 COHMANDS 

3.2.3 CHAN$E_OECK 1 CHO 

processor 1 p s This 1 to 31 character string is used to 1 

identify the processor that will use the source data in 2 

this deck as inpu t. I 

* 

group 1 g s This is a 1 to 31 character croup name to , be 5 

associated with this deck. Aternatively a list of croup 6 

names may be given separated by commas and enclosed in f 

parentheses. 8 

9 

del ete__group I dg 5 This parameter allows group names to 18 

be deleted from the deck header. The value of this It 

parameter is given as a single group name or a list of 12 

group names separated by commas and enclosed in 13 

parentheses. 15 

15 

tab I notab t If the TAB keyword is used or this 116 

parameter is given positional I y f this one character II? 

string specifies a default tab character for use when 118 

editing this deck. If the N0TA8 keyword is given tabbing $19 

will be deselected by default for this deck. 128 

21 

columns I col t These integers between 1 and 256 are tab 21 

stops to be added to the deck header. A series of tab 23 

columns to be added may be specified as a value list (see 2% 

the Parameter lists section of the NOS/VE ERS I. A 25 

maximum of 256 tab columns may be specified. When the 26 

delete^columns parameter is also included on this 27 

command* the tab stops it specifies are cleared before 28 

the tab stops specified by the columns parameter are 29 

set. 30 

31 

del ete_columns I dcol 8 These integers between 1 and 256 3 32 

are default tab stops for editing to be deleted from the 138 

deck header. A series of tabs stops may be specified as 13% 

a value list fsee the Parameter lists section of the 35 

NOS/VE ERS I. 36 

3? 

width % w s This is the default line width to be used 138 

when this deck is expanded and to be used by the SCU 139 

editor. The value must be given as an integer between 5**8 

and 256. Specifying as a width selects the defaults of I VI 

supplying no trailing blanks when this deck is expanded %hZ 

and allowing lines up to 256 characters to be entered l**3 

with the editor. ik% 

«»5 

lid s This parameter is the default line identifier 8<*6 

placement when this deck is expanded. This parameter can l**F 

be given as one of 3 values. 1^8 
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3.0 COHMANDS 

3.2*3 CHANGE_DECK 1 CHO 

1 
right t Line identifiers will be placed on the i 2 
right. 1 3 

* 
left s Line identifiers wilt be placed on the left, 1 5 

6 
none s Output lines will contain expanded text I ? 
only. 19 

9 : 
base 1 ba s This is the name of the file containing the lit 
base source library. If this parameter is not given an 511 
attempt is made to access a file with the name BASE. 112 

13 
result I r s This is the file to receive the modified 11* 
source library. If this parameter is not given, the 115 
modified source library will be written to a file named 116 
RESULT. 117 

18 
expand 1 exp 1 no_expand 1 nexp 5 if the N0_EXPAN0 119 
Keyword Is included on this command these decks will only 12S 
be written to the expanded text file produced by the 121 
EXPAND_DECK command as a result of processing the text \Z2 
embedded directives *CQPY and *CQPYC. If the EXPAND 123 
Keyword is included or this parameter is omitted 12* 
entirely* these decks will be written to the expanded 125 
text file by the EXPAND_OECK command whether named on the 126 
command or on *C0PY and *C0PYC directives. I2F 

28 
status I st s See basic status concept. 129 

3f 
Examples 131 

SCU.CHD scm$deiete p= - CYBIL* 132 

33 

In this example CYB1L is identified as the processor that 13* 

will use this deck as input. The description of the deck 135 

scmSdelete will be obtained from file BASE and the modified 136 

source library will be written to the file RESULT. 53? 

38 
39 
*0 
*I 
*2 
*3 
** 
*S 
*6 
*? 
*« 
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3,0 COMMANDS 

3.2. *> PURGE_DECK I PUD 



3*2. k PURG£_D£CK J PUD 

This command is used to remove decks from a source 
library. This command will be rejected if the user name it is 
executed under does not have an authority equal to or higher 
than the state of the modification associated with this deck's 
creation. 

purge_deck name=<deck_name> 

Cbase=<f i le_name>] 
fresul t=<f i le_name>! 
Istatus=riir2lr3lef 3 

name I na s This is the name of a deck to be purged. 
Alternatively a list of names separated by commas and 
enclosed by parentheses may be given or a range of decks 
may be indicated by giving the first and last deck names 
to purge separated by ellipses. 

base I ba s This is the name of the file containing the 
base source library. If this parameter is not given an 
attempt is made to access a file with the name BASE. 



the modified 
not given* the 
a file named 



result I r s This is the file to receive 
source library. If this parameter is 
modified source library will be written to 
RESULT. 

status I st : See basic status concept* 

Examples 

scu.purge_deck soup.. nuts current shorter 

In this example the source library on file SHORTER will 
contain all of the decks in the source library on file CURRENT 
except those in the range from soup to nuts. 



1 
2 
3 
% 
5 
6 
? 
8 

319 
til 
112 

13 

15 

16 

If 

19 

19 

12® 

121 

122 

23 

12* 

125 

126 

32? 

28 

12* 

39 

131 

132 

33 

3*i 

35 

36 

3* 

30 

39 

VI 

<♦! 

h2 

k% 

<>« 

*f5 

**6 

1+7 

t+n 
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3*0 COMMANDS 

3,2.5 SEQUENCE_DECK 1 SEO 

3,2,5 SEQUENCE_DECK I SEO 1 

2 
This command is used to resequence a deck. Only lines 3 
associated with modifications of state 5 will be altered. The 5 
modification identifier under which the deck was created will 5 
be associated with each of these lines on the result library, 6 
All history information concerning previous modifications to 7 
these lines will be discarded* including inactive lines, 8 
Because of this* resequencing is recommended only when a deck 9 
has attained some significant milestone* This command is 10 
rejected if it is not executed under the user name which has 11 
authority k for the library, 12 

13 

sequence_deck name=<deck_name>lal I 15 

£base=<f ile_name>] 115 

Cresul t=<f i le_name> J MS 

Cstatus=rilr2 5r3ief J I IF 

16 
name 3 na I all s This is the name of a deck to be 19 
resequenced. Alternatively a list of names separated by 28 
commas and enclosed by parentheses may be given or a 21 
range of decks may be indicated by giving the first and 22 
last deck names to resequence separated by ellipses* Use 23 
of the alternate keyword ALL to specify this parameter 2% 
has the same effect as specifying the first and last 25 
decks as a range* 26 

21 
base % ba s This is the name of the file containing the 328 
base source library. If this parameter is not given an 129 
attempt is made to access a file with the name BASE* 139 

31 
result I r 8 This is the file to receive the modified 132 
source library. If this parameter is not given, the 533 
modified source library will be written to a file named 135 
RESULT, 5 35 

36 
status I st J See basic status concept. 13? 

38 
Examples 139 

scu,sequence_deck name=(8ob*Carol «Ted,AI ice«a.*z) o!dp1,r=|oe 55® 

51 
52 
53 
55 
55 
56 
51* 
58 
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3*0 COMMANDS 

3.2.6 MOVE DECK i MOO 



3.2.6 M0V£_DECK I MOO 1 

2 

This command is used to move a deck to another logical 3 

position on the source library. % 

5 
move_deck narae=<deck_name>!al I 1 6 

t at ter=<deck_name>!before=<deck_name>Ialphabet id I ? 
£base=<f i le_name>l * 8 

tresul t=<f i le_name> J 1 9 

£status=rl?r23r35ef 1 316 

If 
name I na I all s This is the name of a deck to be 5 12 
moved. Alternatively a list of names separated by commas 813 
and enclosed by parentheses may be given or a range of 1% 
decks may be indicated by giving the first and last deck 15 
names to move separated by ellipses. An error will be 16 
reported i f an attempt is made to move a range of decks 1? 
to a destination within the range. The alternative 118 
keyword ALL will be allowed only if alphabetic ordering flS 
is selected and will have the effect of sorting the decks 123 
on the result library. 121 

21 
after S af 5 before I be ! alphabetic I alpha s This 23 
parameter can be used to name a deck on the library after 2% 
or before which this deck will be moved. If the keywords 25 
AFTER or BEFORE are used alone, this deck will be moved 26 
to the end or beginning of the deck sequence 2? 
respectively. Alternatively the ALPHABETIC keyword may 28 
be used to indicate that the deck will be moved to 29 
alphabetic sequence. If this parameter is omitted the 30 
deck will be moved to alphabetic sequence. 31 

32 
base t ba : This is the name of the file containing the 333 

base source library. If this parameter is not given an 535 
attempt is made to access a file with the name BASE. 135 

36 
result ? r s This is the file to receive the modified S3? 
source library. If this parameter is not given, the 138 
modified source library will be written to a file named 139 
RESULT. IV® 

<♦! 
status 3 st s See basic status concept. %hlL 

k% 
Examples ikU 

scu.move_deck r=newpl na = Anatoly after=Bobby oldpl %**% 

kB 

In this example the use of keywords has allowed the *♦? 

parameters to be specified in something other than the default V8 
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3.0 COMMANDS 

3*2.6 MOVE_DECK 1 MOD 



sequence. % 

2 
3 

5 



8 
9 
19 
11 
12 
13 
15 
15 
16 
1? 
18 
19 
28 
21 
22 
23 
2H 
25 
26 
2? 
28 
29 
38 
31 
32 
33 
35 
35 
36 
37 
38 
39 
<f0 
kl 
W2 
**3 
** 
<»5 
k% 
**7 
if8 
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3*0 COMHANDS 

3.2.7 EXPAND_DECK J EXPO 



3.2.7 EXPAND_OECK 5 EXPO 

This command expands a source deck into a file where it may 



be used as Input to some 
expansion, text embedded 
will be processed. For 
section on text embedded 



processor. During the course of 
directives intermixed with the source 

a description of these, see the 
directives. 



exoand_deck 



tname=<deck_name> !al 1 1 

Ccomp i I e= < I oca l_f i I e_name > 1 

fcriteria=<local_f i le_name> ] 

€width=<in teger>] 

1 1 id=<l ine_identi f ier_placeraent_keyword>1 

Cbase=< f i I e_name> 1 

C I ist~<local_f ile_name>l 

€depth=<integer>1 

C brief Iful 13 

£ I iforary_order 1 command_order 1 

tstatus=rl5r2!r33ef 1 



name I na I all t 
expanded. Alternatively 
commas and enclosed b 
range of decks may be in 
last deck names to expan 
of deck ranges on this c 
decks occurring on the 
recommended (See descrip 
below). Use of the alte 
parameter has the same e 
from a combined library 
omitted. the source d 
determined solely by the 



This is the name of a deck 
a I 1st of names separat 
y parentheses may be give 
dicated by giving the firs 
d separated by ellipses. T 
ommand for anything other 

last named source library 
tion of the LIBRARY_ORD£R k 
mate keyword ALL to specif 
ffect as specifying all 
as a range. If this parame 
ata to be expanded wil 
contents of the criteria f 



to be 
ed by 
n or a 
t and 
he use 
than 
is not 
eyword 
y this 

decks 
ter is 
I be 
ite« 



compile I c s This is the 
expanded text. This file will 
after the command is processed, 
given* the expanded text will be 
COMPILE. 



name of the file for the 
be rewound before and 
If this parameter is not 
written to a file named 



criteria I cr s This names a file which can foe used to 
further define which source data is to be expanded. If 
no criteria file is used, the selected decks will be 
expanded with all modifications included. 

width I w s This is the length of the output lines 
excluding line identifiers if they are requested. A 
maximum value of 256 will be allowed. An additional 17 



£ 
2 
3 

5 

6 

f 

8 

9 

it 

II 

12 

13 

II* 

115 

16 

II? 

18 

119 

28 

2f 

22 

23 

Z% 

25 

26 

127 

128 

29 

3i 

31 

32 

Z% 

3% 

135 

136 

137 

38 

39 

<t® 

<*1 

*2 

1*5 
<*6 
<*7 
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3.0 COMMANDS 

3.2.7 EXPAND_DECK 1 EXPO 

columns will be necessary for a line identifier since a 1 
blank Milt separate the modification identifier from the 2 
sequence number and another blank mitt separate the 3 
entire line identifier from the expanded text. If is % 
specified as the value for this parameter* output lines 5 
will be actual length. If this parameter is not given on 1 6 
the command* the default value from the deck header wilt 1 7 
be used. If the width selected results in a line being I 8 
truncated* an error will be reported. ! 9 

10 
lid s This parameter can be given as one of 3 values* Ml 

12 
right : Line identifiers will be placed on the 111 
right. II* 

15 
left s Line identifiers will be placed on the left. 116 

if 
none 5 Output lines will contain expanded text lit 
only. 119 

28 
If this parameter is not given on the command* the 121 
default value from the deck header is used. 122 

23 
base 1 ba 5 This is the name of the file containing the 2*» 
base source library. Alternatively a list of file names 25 
may be given to allow decks to be expanded from alternate 126 
source libraries. See normal search order. If this S2F 
parameter is not given an attempt is made to access a 128 
file with the name BASE. 329 

38 
list 1 I s This is the name of the file to receive the 131 
listing. If this parameter is not given* the file name 132 
OUTPUT will be used. 133 

3* 
depth : This non-negative Integer limits how deeply 135 
nested *C0PY or *C0PYC text embedded directives will be 13€ 
processed. *C0PY or *C0PYC directives encountered at the 137 
next level will be included in the expanded text file as 138 
text 1 ines. If this parameter is omitted* *C0PY or 139 
♦COPYC directives will be processed wherever they are \kQ 
encountered. *♦! 

k2 
brief 1 br 1 full 3 fu 8 If the BRIEF keyword is present 1^3 
or this parameter is omitted* the list will contain only lk% 
a report of errors which may have occurred while i<*5 
processing the command. If the FULL keyword is present* l**6 
an explanation of which library each deck was selected !*#? 
from will be included when the command accesses multiple 1^8 
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3.0 COMMANDS 

3.2.7 EXPAND_DECK i EXPO 

source I ibraries. % t 

2 
I ibrary_order 1 lo 1 command_order t co * If this command I 3 
includes the COMMANQ_ORDER keyword the decks will be % h 
written to the excanded text file in the order they are 5 
specified on the command. If the LIBRARY_ORDER keyword 6 
is included or this parameter is omitted* the decks are 7 
written' to the expanded text file in the order that the 8 
decks occur on the base source library for in the order 9 
they would occur on a combined source library if one were 113 
produced from the list of libraries specified by the base 11 
parameter). 12 

13 
status ! st s See basic status concept. i% 

15 
Example 1? 116 

scu.expand_deck mydeck ba-oldpl H7 

18 

In this example the deck mydeck is expanded from the source 19 

library on the file GLDPL and written on the expanded text 128 

file named COMPILE. 121 

22 
Example 2* 121 

scu.expand_deck scm$change ba={myopl * fcybccmn,ses) I 12** 

125 

In this example the deck scm$change is expanded from the 126 

libraries MYOPt and CYCCCMN and written on the expanded text 12? 

file named COMPILE. In this case CYBCCMN was located under 128 

another user name. 129 

31 
31 
32 
33 
3¥ 
35 
36 
3? 
38 
39 
*♦« 
*♦* 

V3 
H* 

hS 

<f8 
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3.0 COMMANDS 

3.2.8 EXTRACT_D£CK 3 EXTO 

3.2.8 EXTRACT_OECK I EXTO i 

2 

This command performs a function similar to £XPANO_DECK 3 

with the exception that text embedded directives are not 4 

processed tout included as text. 5 

6 

extract_deck Cname : =<deck_name>ial f 3 f 

Csource-<local_f ife_name>1 8 

tcri teria=<local_f il e_narae>l 9 

£width=<integer>1 IS 

C lid=<! in evident if ier_pl acement_keyword>1 it 

tbase=<f i le_name>l 312 

C I ist=<l ocal_f Ile_name>1 113 

ibrieflfulll 314 

f I ibrary_orderfcommand_order1 15 

texpandlno_expandJ 116 

t deck_directives5no_deck_direct i vesl 5 If 

tstatus=ri?r21r3 3ef] 318 

19 

name t na ! all 5 This is the name of a deck to be 328 

extracted. Alternatively a list of names separated by 121 

commas and enclosed by parentheses may be given or a 122 

range of decks may be indicated by giving the first and 523 

last deck names to extract separated by ellipses. The 125 

use of deck ranges on this command for anything other 125 

than decks occurring on the last named source library is 326 

not recommended CSee description of the LI BRA RY_ ORDER 32? 

keyword below). Use of the alternate keyword ALL to 28 

specify this parameter has the same effect as specifying 29 

all decks from a combined library as a range. If this 38 

parameter is omitted* the source data to be extracted 31 

will be determined solely by the contents of the criteria 32 

file. 33 

3* 

source I s s This is the name of the file for the 3 35 

extracted text. Decks will be separated by end of 336 

partition tend of record on NOS170). This file will be S3? 

rewound before and after the command is processed. If 138 

this parameter is not given* the extracted text will be 39 

written to a file named SOURCE. 40 

41 

criteria I cr s This names a file which can be used to 42 

further define which source data is to be extracted. If 43 

no criteria file is used* the selected decks will be 4% 

extracted with all modifications included. 45 

46 

width I w s This is the length of the output lines 4? 

excluding line identifiers if they are requested. A 48 
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3,0 COHMANOS 

3. 2,8 EXTRACT_D£CK I EXTO 

maximum value of 256 will be allowed* An additional 17 1 
columns will be necessary for a line identifier since a 2 
blank will separate the modification identifier from the 3 
sequence number and another blank will separate the 4 
entire line identifier from the extracted text* If is 5 
specified as the value of this parameter* output lines 6 
will be actual length. If this parameter is not given on % 7 
the command, the default value from the deck header will 1 8 
be used* If the width selected results in a line being I 9 
truncated, an error will be reported* 118 

11 
lid s This parameter can be given as one of 3 values. 112 

11 
right s Line Identifiers will be placed on the 1% 
right. 15 

1€ 
left s Line identifiers will be placed on the left* IF 

18 
none : Output lines will contain extracted text 19 
only. 29 

21 
If this parameter is not given on the command, the \ZZ 
default value from the deck header is used* 123 

24 
base I ba i This is the name of the file containing the 25 
base source library. Alternatively a list of file names 26 
may be given to allow decks to be extracted from 127 
alternate source libraries. See normal search order* If 128 
this parameter is not given an attempt is made to access 129 
a file with the name BASE. 83tJ 

31 
list I l s This is the name of the file to receive the 132 
listing. If this parameter is not given, the file name 138 
OUTPUT will be used. 134 

35 
brief 1 br 1 full I fu s If the BRIEF keyword is present 136 
or this parameter is omitted, the list will contain only 13? 
a report of errors which may have occurred while 138 
processing the command* If the FULL keyword is present, 139 
an explanation of which library each deck was selected 148 
from will be included when the command accesses multiple 141 
source libraries. 542 

43 
I ibrary^order 1 lo 1 command_order 1 co s If this command 144 
includes the COMMAND_OROER keyword the decks will be 145 
written to the extracted text file in the order they are 46 
specified on the command. If the LI8RARY_0RDER keyword V? 
is included or this parameter is omitted, the decks are 48 
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3.Q COHHANOS 

3.2.8 EXTRACT_DECK I EXTO 

written to the extracted text file in the order that the f 
decks occur on the base source I ibrary for in the order 2 
they mould occur on a combined source library if one were 3 
produced from the list of libraries specified by the base % 
parameter). 5 

6 
expand 3 exp 1 no_expand 1 nexp 5 If the EXPAND keyword 3 ? 
is present on this comiandt only decks without the 3 8 
NO_EXPAND attribute will be written to the SOURCE file. 1 9 
If the NG_EXPAN0 keyword is present, only decks with the tit) 
NO_£XPAND attribute will be written to the SOURCE file. lit 
If neither keyword is present* decks will be written to 112 
the SOURCE file without regard to their N0_EXPAND 313 
attribute. 11% 

15 
decked irectives 3 6d 3 no_deck_directives 5 ndd t If the 316 
DECK_DIR£CTIV£5 keyword is present, OECK text embedded II? 
directives will precede each deck on the SOURCE file. If 118 
the NO_DECK_DIRECTIVES keyword is used or neither keyword 119 
is present, no DECK directives will be written to the 3213 
SOURCE file. 3 2i 

22 
status I st i See basic status concept* 123 

2% 
Examples 3 25 

scu.extract__deck mydeck ba=oldpl 326 

2? 

In this example the deck mydeck is extracted from the 28 

source library on the file OLDPL and written on the text file 29 

named SOURCE. 38 

31 
32 
33 
3% 
35 
36 
3F 
38 
39 
V9 
*♦! 
kZ 
%3 
i+t* 
<f5 
<+6 
i|f 
*+« 
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3.0 COMMANDS 

3.2.9 OISPLAY_OECK_REFERENCES 3 ODR 

3.2.9 DISPLAY_OECK_R£FERENCES I OOR 1 

2 

This command displays the names of the decks which 3 S 

reference the named deck directly or indirectly by *COPY text I % 

embedded directives. It can optionally also display the names j 5 

of the decks referenced by the named deck directly or I 6 

indirectly through use of the *COPY text embedded directive. I f 

8 

dlsplay_deck_references name=<deck_name>3al I 9 

Cbase=<f i le_name>] lit 

t I ist=<local_f 1 le_name>] 311 

tbrieflfulU 112 

£status=rllr23r33ef 1 113 

1* 

name 3 na 3 all % This is the name of a deck to be cross 15 

referenced. Alternatively a list of names separated by 1€ 

commas and enclosed by parentheses may be given or a IF 

range of decks may be indicated by giving the first and 18 

last deck names to cross reference separated by 19 

ellipses. Use of the alternate keyword ALL to specify 20 

this parameter has the same effect as specifying the 21 

first and last decks as a range. 22 

23 

base I ba s This is the name of the file containing the i2% 

base source library. If this parameter is not given an 125 

attempt is made to access a file with the name BASE* 328 

ZT 

list I I s This is the name of the file which receives 28 

the listing. If this parameter Is not given, the file 29 

name OUTPUT will be used. 3© 

31 

brief 3 br 3 full I fu J If the BRIEF keyword is included 32 

on this command or this parameter is omitted entirely* 133 

only the decks which reference this deck will be listed. 33* 

If the FULL keyword is used* the list of decks referenced 835 

by this deck will be shown as well* References to decks 13*1 

not on the base source library will be flagged as 33f 

external. 338 

39 

status I st s See basic status concept. \t*% 

Examples 3<t2 

SCU.ODR scc$displ ay_defaul t_values scupl 1V3 

**% 

The command in this example displays the names of all the *f5 

decks on the source library on file SCUPL which refer to the ^6 

deck sccSdispl ay_def aul t_values directly or indirectly through S**? 

*C0PY directives. 1^8 
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3,0 COWHANDS 

3.2.10 DISPLAY_0£CK__LIST I COL 



3.2.10 DISPLAY_DECK_LIST 1 DDL 

This command displays the list of decks on a source 
I ibrary. 

display_deck_l ist Cbase=<f i le_name>] 

1 1 ist=<iocal_f i le_name>3 
(brief 1 full! 
Cstatus=rllr2tr3ref 1 



base 1 ba s This is the name of the 
base source library. Alternatively a 
may be given to give a combined 
parameter is not given an attempt is 
file with the name BASE. 



file containing the 
list of file names 
deck I ist. If this 
made to access a 



I This is the name of the file which receives 
• If this parameter is not given* the file 
wi 1 I be used. 



fist 1 1 

the listing- ., ..,._ _ 

name OUTPUT will be used. 



brief 1 br 1 ful I 1 fu s If the command contains the key 
word BRIEF or this parameter is omitted* a shorter form 
of the listing will be produced. If the FULL keyword is 
present a more detailed listing will be given. Currently 
these listings are identical. 

status 1 st : See basic status concept. 



Examples 
SCU.DOL scupl 



sculist 



3 

h 

5 

I 6 

1 7 

1 8 



11 
112 
113 
3 ll» 
115 
16 
1? 
1* 
19 
28 
21 
21 
23 
2% 
25 
26 
27 
28 
« 29 
131 
31 
32 
33 
3% 
35 
36 
3? 
38 
39 
tf9 
*fl 
kZ 

<»6 
US 
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3.0 COMMANDS 

3.2.11 DISPLAY_GROUP 1 DIG 

3.2.11 DISPLAY_GROUP I DIG 1 

2 

This command will display a fist of the decks associated I § 

with a group and optionally the short form of the deck 1 h 

description {see DISPLAY_DECK> for all decks associated with I 5 

this group name. 6 

? 
displ ay_group group=<group_name> 1 

tfoase=<f i le_name>] I 9 

tl ist=<local_f i le_name>1 110 

tforief 3 fuill Hi 

£status=rlir21r3lef 1 112 

13 
group S g s This is the name of the group. 1* 

15 
base % ba s This is the name of the file containing the 16 

base source library. Alternatively a list of file names flF 
may be given to allot* a user to interrogate a set of 111 
source libraries that are frequently used together. If 119 
this parameter is not given an attempt is made to access 120 
a file with the name 8ASE. 121 

22 
list I I z This is the name of the file which receives 123 
the listing. If this parameter is not given, the file \2% 
name OUTPUT will be used. 125 

26 
brief I br I full I fu 5 If the command includes the 12? 
keyword BRIEF, only the list of decks associated with the S2S 

group will be displayed. If the keyword FULL is present, 129 
the short form of the deck description for each deck will 130 
be given as well. The shorter display is selected by 131 
default. 132 

33 
status I st s See basic status concept. S3S 

35 

36 

Examples S3? 

scu.disolay^group al l_iou_programs ol dpi 831 

39 
<t§ 

3.2.12 OISPLAY_GROUP_LIST I DGL kl 

k2 

This command will list all the group names associated with «»3 

this source library as well as the decks associated with each k$ 

group. US 

<*6 
displ ay_grouo_l ist £base=<f II e_name>l IkW 

f I lst=<local_f ile_name>l 1^8 
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3.0 COMMANDS 

3.2.12 DISPLAY GROUP LIST I DGL 



tbrief 1 fuill 
Cstatus=rilr21r31ef 1 

base I tea * This is the name of the file containing the 
base source library. Alternatively a list of file names 
may be given to produce a combined group list. If this 
parameter is not given an attempt is made to access a 
file with the name BASE. 

list i i s This is the name of the file which receives 
the listing* If this parameter is not given* the file 
name OUTPUT will be used. 

brief 5 br 5 full 1 fu 3 If the command includes the 
BRIEF keyword or this parameter is omitted entirely* the 
display will contain only the group names. If the FULL 
keyword is given. the group names as well as the decks 
associated with each group will be displayed. 

status 1 st s See basic status concept. 



Examples 
SCU.OGL testpl 



1 f 

1 2 

3 

% 

5 

1 6 

I 7 

t » 

9 

18 

it 

12 

If 

Ik 

15 

16 

17 

i» 

19 

2® 

21 

122 

52S 

2% 

25 

26 

2? 

28 

29 

39 

31 

32 

33 

3% 

35 

3« 

37 

311 

39 

<tt! 

k2 
«*3 

t*S 
kS 
t*f 
<*8 
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3.0 COMMANDS 

3,3 MODIFICATIONS 



3.3 HOOK 

The following commands together with the SCU editor are 
used to manipulate modifications to source libraries. 



3.3.1 CREATE_MODIFICATION 1 CRM 



This command 
information to 
Modifications are 



can be used to create the descriptive 
be associated with a modification, 
always created with state 0* 



create_modi f ication modi f icat ion=<modif ication_name> 

€ f ea ture= < f ea t ure_name > 1 
f author=<author_name_strIng>l 
£description=<descript ive_string>l 
lbase=<f i le_name>1 
Cresutt=<f i le_name>l 
tstatus=rllr2lr3ief 1 

modification S mod t This 1 to 9 character field is 
modification name. Alternatively a list of names may 
given. 



the 
be 



feature % fe 5 This is a 1 to 31 character 
to be associated with this modification. 



feature name 



author 3 au 
to identify 



i This 1 to 31 character string can be used 
the individual who wrote this modification. 



description % de s This 1 to 256 character string can be 
used to describe the modification. It is suggested that 
this be used to point to official documentation for the 
modification such as psr numbers or design documents. 



base t ba * This is the name of the file 
base source library. If this parameter 
attempt is made to access a file with the 

result I r : This is the file to receive 
source library. If this parameter is 
modified source library will be written to 
RESULT. 

status I st s See basic status concept. 



containing the 
is not given an 
name BASE. 

the modified 
not given* the 
a file named 



Exampl e? 

SCU. CRM 



I 

2 
3 

* 

5 

6 

H 

8 

9 

It 

11 

12 

13 

1* 

15 

I If 

ui 
ti9 

29 

21 
121 
123 

2* 
125 
3 28 

21 
128 
129 

3D 
S3£ 
132 
131 
13* 

35 
136 
?3f 
138 

39 
Sift 
1*1 
1*2 

** 
1*8 



COMPANY PRIVATE 



3-^0 
CDC SOFTWARE ENGINEERING SYSTEM 

03/2*r/8Q 
£RS for Source Code Utility (NOS 170 Version! REV? J 

3,0 COMMANDS 

3*3*1 CREATE_MODIFICATION 1 CRM 

mod=mymod •• 1 

f esfy^appearance • • 12 

au=*M. J. Perreten* .. I 3 

de="sbort , fat* brown hair* beard* • • fr 

ba=oldfact •• 3 

r=newfact 6 

7 

8 

3,3*2 DISPLAY_MODIFICATION I DIM 9 

18 

This command displays descriptive information about a 11 

modif Ication. 12 

IS 
displ ay_modi f icat ion modif ication=<modi f icat Ion_name>!al 1 11* 

tname-<deck_name>l 115 

Cbase=<f ile__name>1 116 

£ I ist=<l ocal_f ile_name>l II? 

tfcrief 1 ful 11 Ul 

Cstatus=rlir2!r31ef 3 119 

28 
modification 5 mod t ail : This Is a 1 to 9 character S2f 
modification name. Alternatively a list of modification 122 
names may be given separated by commas and enclosed in 323 
parentheses or a range of modifications may be indicated 52% 
by giving the first and last modification names separated 125 
by ellipses* Using the keyword ALL has the same effect 128 
as specifying the first and last modifications on the 12? 
library as a range* 128 

29 
name I na : This is the name of a deck. If this 339 
parameter is specified* descriptive information will be 331 
given about only the named modification as it applies to 32 
this deck* 33 

3% 
base 1 ba s This is the name of the file containing the 135 

base source library. If this parameter is not given an 3 3§ 
attempt is made to access a file with the name BASE. 13? 

38 
list J I t This is the name of the file which receives 39 
the listing. If this parameter is not given, the file **9 
name OUTPUT will be used. kt 

hZ 
brief I br 1 full I fu : If the FULL keyword is included «»! 
on this command, the descriptive information about this *♦% 
modification will be displayed as well as every line of kS 
text altered by this modification. If the BRIEF keyword ^6 
is included or this parameter is omitted entirely, then **? 
only the descriptive information about this modification *»8 
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3.0 COMMANDS 

3.3*2 DISPLAY_MOOIFICATION I DIM 

is displayed. 1 

2 
status 1 st : See basic status concept. 3 

Example? I 5 

scu«display_modif ication mod=psrl23456 na=routineb ba=syspi .. % 6 
i=fixforb full IF 

8 

In this example the descriptive information about the 9 

modification named psrl23456 is listed on the file FIXF0R8 It 

along **ith any lines altered by this modification in the deck it 

routineb. 12 

13 
1% 
15 
16 
if 
18 
19 
28 
21 
2t 
23 
2% 
25 
2S 
2f 
28 
29 
3 8 
31 
32 
3f 
3% 
35 
36 
3? 
38 
39 
V8 
kl 
1*2 
h% 
k% 
kS 

ke 

47 
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3.0 COMMANDS 

3*3.3 CHANGE^MODIFICATION 1 CHM 

3.3.3 CHANG£_MODIFICATION I CHM 1 

£ 

This command enters or modifies descriptive information 1 

about a modification. f» 

% 
change__modif icat ion modi f icat ion=<modif lcation_name>?al I \ 6 

t f eature=<f eature_name>l I f 

Cauthor=<autbor_name_string>] I % 

Idescript ion=<descriptive_string>] 1 9 

tbase=<f i le_name>1 118 

Cresuit=<fi le_na , ae>l Mi 

£state=<integer>3 It 

tstatus=rilr2?r31ef 1 113 

1* 
modification 5 mod i all i This is a l to 9 character lis 
modification name. Alternatively a list of modification 116 
names may be given separated by commas and enclosed in If 
parentheses or a range of modifications to be changed may IS 
be indicated by giving the first and last modification 1$ 
names separated by ellipses. Using the keyword ALL has 329 
the same effect as specifying the first and last 121 
modifications on a library as a range. 122 

21 
feature I fe s This is a 1 to 31 character feature name 125 
to be associated with this modification. !25 

26 
author I au s This 1 to 31 character string can be used 12? 
to identify the individual who wrote this modification. 128 

29 
description I de * This I to 256 character string can be 138 
used to describe the modification. It is suggested that 131 
this be used to point to official documentation for the 132 
modification such as psr numbers or design documents* 133 

3*t 
base I ba t This is the name of the file containing the 135 
base source library. If this parameter is not given an 136 
attempt is made to access a file with the name BASE. S3? 

39 
result I r s This is the file to receive the modified 139 
source library. If this parameter is not given, the 1^8 
modified source library will be written to a file named l**l 
RESULT. 1ii2 

<f3 
state 8 This is the new state for the modification. For !*♦$ 
a user to raise a modification to a given state or lower 1^5 
it from that state to 0» he must have the corresponding !<*8 
authority over the base source library or a higher one. kt 
Values this parameter may assume aret V8 
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3.0 COMMANDS 

3.3.3 CHANGE MODIFICATION 3 CHM 



1 
2 

3 
% 
S 

f 
status I st « See basic status concept. ! 8 

9 
Example: 118 

SCU.CHM myraod de=*snort, fat, bal d» beard - stated til 

12 
13 
IS 
15 
16 
17 
18 
19 
28 
24 
21 
21 
2* 
25 
Z% 
2? 
29 
29 
3« 
31 
32 
33 
3% 
35 
36 
3f 
38 
39 
i»9 

ht 
h% 
if* 
<*5 
*6 
<f? 
1*8 
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3.0 COMMANDS 

3.3. h PURGE__MOOIF ICATION S PUM 

3.3.*> PURGE_MODIFICATION 1 PUM t 

2 
This command is used to remove a modification from the 1 3 
source library. In order to purge a modification a user must J % 
have the appropriate authority for the library to manipulate 1 5 
modifcations at this state. One wilt not be allowed to purge I € 
a modification that is associated with the creation of a I ? 
deck. Such decks must be purged first. I 3 

*} 
purge_modif ication modif ication-<modi f ication_name> It 

£name=<deck_name»] II 

Ibase=<f ile_name>1 112 

tresult=<f ite_name>1 113 

Istatus=rl1r21r3ief 1 11$ 

15 
modification 1 mod 8 This is the name of a modification. i« 
Alternatively a list of modification names may be given 1? 
separated by commas and enclosed in parentheses or a It 
range of modifications may be indicated by giving the 19 
first and last modification names separated by ellipses. 28 

21 
name 5 na s This is the name of a deck. If this 22 
parameter is given, only the part of the modification 23 
that applies to this deck will be removed. Alternatively 2% 
a list of names separated by commas and enclosed by 25 
parentheses may be given or a range of decks may be 26 
indicated by giving the first and last deck names 2? 
separated by ellipses. 28 

29 
base I ba 8 This is the name of the file containing the 138 
base source library. If this parameter is not given an 131 
attempt is made to access a file with the name BASE. 132 

33 
result 5 r 3 This is the file to receive the modified S3* 
source library. If this parameter is not given * the 135 
modified source library will be written to a file named 13® 
RESULT. ?3F 

38 
status 1 st s See basic status concept. 139 

hi 
Examples Ibi 

scu.purge_modi f ication fangs na=serpents ba=beasts r=animals 1^2 

43 
**% 

t*% 
*♦? 
**8 
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3.0 COHHANOS 

3.3.5 SEQUENCE^MGDIFICATION I SEH 

3.3.5 SEQUENCE_HOQIFICATIGN 1 SEM 1 

2 

This a Hows a user to resequence a modification so that S 

sequence numbers will appear in the order that source fines % 

appear in the deck rather than in the order they were 1 5 

introduced. This is only allowed for modifications in state 3 8 

fl. All inactive lines introduced under this modification name 1 f 

wil I be discarded. t 9 

sequence_«odif ication modif ication=<modif icat ion_name> 18 

tname=<deck_name>! 11 

£base=<f ile^name> J 112 

tresult=<f i le_name>] 111 

tstatus=rilr2lr3lef ] ill* 

15 
modification 1 mod t This is the name of a modification. IS 
Alternatively a list of modification names may be given If 
separated by commas and enclosed in parentheses or a IS 
range of modifications may be indicated by giving the 19 
first and last modification names separated by ellipses. 2t3 

21 
name I na s This is the name of a deck. If this ZZ 
parameter is given, only the part of the modification 23 
which applies to this deck will be resequenced. 2% 
Alternatively a list of names separated by commas and 25 
enclosed in parentheses may be given or a range of decks 26 
may be indicated by giving the first and last deck names 2? 
separated by ellipses. 26 

29 
base 1 ba s This is the name of the file containing the 136 
base source library. If this parameter is not given an 131 
attempt is made to access a file with the name BASE. 532 

33 
result S r : This is the file to receive the modified 13<» 
source library. If this parameter is not given* the 135 
modified source library will be written to a file named 130 
RESULT. 13? 

38 
status 1 st s See basic status concept. 139 

<*§ 
Examples l<tl 

scu.sequence^modi f icat ion psr 123^5 1 h 2 

Ml 
<♦% 
<f5 
k6 
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3*0 COMMANDS 

3.3.6 EXTRACT_MQDIFICATION ! EXM 

mm**** *m<*w mm mm -mm mm mm mm mm mm mm mm mm nw> mm mm mm mm mm mm mm mm mm mm mmmmmmmmmm mmmmmmmmmmmmmmmmmmmmmm. . mm mm m m m m mm mm mm mm m m nu ll mm mm mm mm -mm *m m* mm mm. m$ mm, mm mm mm 

3.3.6 EXTRACT_MODIFICATION I EXM i 

2 

This command is used to extract a modification from a I 9 

source library in the form of the editor commands INSERT* I * 

DELETE and REPLACE. I S 



extract_modl f ication modi f lea tion=<modi f ication_name> 

e el ^commands- <l oca 1 _f i I e_name > 
tname=<deck_name>1 

f ^aees /f 1 la *s a ma %. 1 



? 

8 

, , 19 

C tase=<f ile_name>3 J 10 

Isculupdate J III 

Istatus*rl1r2lr3tef 3 112 

1$ 
modification I mod 5 This is the name of a modification. 81* 
Alternatively a list of modification names may be given 115 
separated by commas and enclosed in parentheses or a 116 
range of modifications may be indicated by giving the 117 
first and last modification names separated by ellipses* 118 

19 
edit_commands 1 ec t This is the name of the local file 2§ 
to receive the edit commands generated by this command* 21 

2t 
name S na 8 This is a deck name. If specified enly that 123 
part of the modification which applies to this deck will 12* 
be written to the E0IT_C0MMAN0S file. 125 

26 
base I ba s This Is the name of the file containing the 12? 
base source library. If this parameter is not given an 329 
attempt is made to access a file with the name BASE. 129 

30 
scu I update 8 If the UPDATE keyword is specified the 131 
modification will be externalized as a six bit display *32 
code UPDATE correction set containing *BEF0RE» *INSERT 139 
and *DELETE directives. If the SCU keyword is given or 13% 
this oarameter is omitted entirely, the modification wilt 135 
be externalized as the ASCII SCU editor commands INSERT* 136 
OELETE and REPLACE. 13? 

38 
139 

Examples 1*1 

scu.extract_modif ication fred ec=comfile ba=pets %W2. 

*3 
*% 
hS 
*6 
*? 
V8 
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3.0 COMMANDS 

3*3.7 DISPLAY_MOOIFICATION_LIST 1 OML 

mm mm mm mm mm mm mm mm mm .mm Mm mm mm mm mm, mm m m m w mm mii m m m m m m mm -mm mm m m m m m m mm > mm mm m m m m mm . mm mm m m mm m m mm mm mm> -m m m m m$ mm mm* mm mm m m mm mm mm mm *m mm mm mm mm mm mm mm m m . mm: mm mm mm 

3.3.7 0ISPLAY_MODIFICATIQN_LIST I OMt 1 

t 

This command displays a iist of all the modifications for a $ 

source I ibrary. % 

5 
display_raodif icat ion_l ist Cbase=<f lle_name>1 \ % 

tl ist=<local_f ile_name>l I 7 

tbrlefS full 1 X 8 

Cstatus=rilr2fr31ef J I 9 

18 
base I ba s This is the name of the file containing the fit 
base source library. If this parameter is not given an 112 
attempt is made to access a file with the name BASE. 113 

1* 
list I I % This is the name of the file which receives 15 
the listing. If this parameter is not given* the file 16 
name OUTPUT will be used. 1? 

1$ 
brief I br I full I fu i If the BRIEF keyword is included 19 
on the command or this parameter is omitted a shorter 2fl 
display will be given. If the FULL keyword is present a 21 
more detailed display will be given. Currently the 22 
displays selected by the two keywords are identical. 23 

2* 
status I st s See basic status concept. 25 

26 
Example: 12? 

SCU.DML library modlist 128 

29 

3J 

3.3.6 DISPLAY_FEATURE I OIF 31 

32 

This command is used to produce a modification description 33 

for each modification associated with a feature. 3% 

35 
d i sp I ay_ feature f eature=<feature_name> J3€ 

£base=<f ile_name>] 13? 

£ I ist=<local_f ile_name>l 138 

f brief X fulll 139 

Cstatus=rilr2lr3lef 1 l<*8 

kl 
feature % fe * This is the name of the feature to be hZ 
displayed. k% 

base I ba f This is the name of the file containing the S^5 
base source library. If this parameter is not given an H»6 
attempt is made to access a file with the name BASE. 1^7 

z»9 
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3,0 COHMANDS 

3.3.8 OISPLAY_FEATURE I OIF 

list I I s This is the name of the file which receives I 
the listing- If this parameter is not given* the file 2 
name OUTPUT will be used* % 

brief % br t full 5 fy J If the BRIEF keyword is included 5 
on this command or this parameter is omitted entirely* € 
the display will include only a list of the modifications I 
associated with the feature. If the FULL keyword is 8 
used* the display will give the modification descriptions 9 
for each of these modifications as well. 18 

II 
status I st s See basic status concept. 12 

I€ 
Examples !I$ 

scu. displ ay_f eature enhanced_network_interface 115 

1% 

IF 

3.3.9 DISPL AY_FEATURE_LIST I OFL IS 

19 

This command produces a list of alt feature names for a 2t 

source library and optionally a list of which modifications 21 

are associated with each. Zt 

23 
disptay_feature_! ist lbase-<f ile_name>] 12% 

t list=<local_f ile_name>l 125 

tfcrief S full! 126 

tstatus=rilr2lr3lef 1 12? 

2* 
base I ba : This is the name of the file containing the 529 
base source library. If this oarameter is not given an ?3f 
attempt is made to access a file with the name BASE. 131 

32 
list I I s This is the name of the file which receives 31 
the listing. If this parameter is not given* the file 3% 
name OUTPUT will be used. 35 

36 
brief I br I full 3 fu : If the BRIEF keyword is included 3? 
on this command or this parameter is omitted entirely* 3$ 
only the list of feature names for this source library 39 
will be displayed. If the FULL keyword is used* lists of <»9 
the modifications associated with each feature will be hi 
included as well. k2 

*f3 
status 3 st J See basic status concept. lb% 

Example: ik% 

scu.display_feature_l 1st myopl 1 *f f 
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3.0 COMMANDS 

3**f CONVERSION AIDS 



3.% PONVER5 : 

Two commands are available to convert source code fro* 
UPDATE and MODIFY program library format to SCU source library 
format. Update and Modify names which do constitute valid SCU 
names can be preserved as will sequence informat ion* AH 
modifications are set to (experimental) state. This is done 
to allow a user the opportunity to add descriptive information 
to key modifications* On conversion *WEOR directives will be 
changed to *W£0P directives* Because only one level of file 
separator will tee supported under NOS/VE* the »WE0F directive 
will be changed to a *WEGP directive as well and the user will 
be informed* 

A command is available to convert source code from SCU 
source library format to UPDATE program library format. With 
the exception of name substitution* sequence information will 
be preserved* 

Deck names or correction identifiers which do not qualify 
as valid SCU deck or modification names will be flagged as 

the user will be expected to effect name 
during a subsequent attempt at conversion* Put 
these conversion utilities will reject names that 
with a letter or $• 

a user may wish to 
because existing names on 



errors and 
substitution 
another way* 
do not begin 

During conversion 
substitutions either 



make name 
the UPDATE or 



MODIFY libraries may not qualify as SCL names or because he 
wishes to use the longer names allowed by SCU* The conversion 
utilities allow for name substitution through the NAME_LIST 
file* Each line in this file is interpreted as the parameters 
of a SCL command as shown be lows 

nos_name=<update_or_modif y_name> 
tscl_short=<modi f ication_name> J 
Cscl_Jong=<d€ck_name>l<def ine_name> ] 

nos_name s This is a the name of an UPDATE or MODIFY 
deck* correction identifier or DEFINEd name* Jifte user 

CiaiS contains characters QtfrerJLhan, t^tfer^ t <jig4ts„anci 



$» . 



sci_short s This is a 1 to 9 character 
name* 



SCU modification 



scl_long s This is a 1 to 31 character SCU deck name or 
OECLARE name (see criteria file directives)* If this 
parameter is omitted the value given for SCL_SH0RT will 
be used* If a value is not given for at least one of the 



1 h 
1 5 
I 6 
i f 
1 * 
I 9 
lit 
lit 
112 
U3 

1% 

15 
1I€ 
11? 

It 
119 
128 
121 
122 
123 
\Z% 
125 
126 
12? 
128 
129 
I3t 

31 
132 
133 
13* 

35 
136 
5 3f 
13* 
139 

*♦! 
\kZ 
\h% 

(*<* 

1<»6 
l<tt 
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3.0 COMMANDS 

3,4 CONVERSION AIDS 



parameters 
reported and 



SCL_SHORT 
conversion 



or SCL_LONG 
inhibited. 



an 



error Hill be 



Examples 

dsd dsd dynamic_display_driver 
zscmere scm$ere scm$replace 
nos^nawe-o 1 d= f ool o I d_ too 1 

On the first line the MODIFY name DSD will continue to be 
used on SCU as the modification name associated with lines 
introduced under that name, but the deck name will have the 
longer* more descriptive form* On the second line a MODIFY 
deck name is being changed to fit the NOS/VE naming pattern* 
On the third line the name OLD=FOOL is being changed to 
OLD_FG0L to make it a legal SCt name. 



3.<».1 C0NVERT_UP0ATE_T0_SCU I CUTS 



This command converts 
source I ibrary. 



an UPOATE program library to an SCU 



convert_update_to_scu 



Coldpl = <local_f ile_name>J 
£result=<f i le_name>l 
tl ist=<local_f ile^name>3 
£name_l ist=<l ocal_f i le_name>l 
tbrief I fulll 
Cascii6^ I ascli3121 
tcriter ia=< local _file_name >] 
Cstatus=rllr2?r3Sef 1 



oldpl s This is the name 
program I ibrary frn sequent; 
is not given an attempt 
file with the name OLDPL. 



of a file containing an UPDATE 

format. If this parameter 

will be made to access a local 



result 5 r s This is the file to receive the new source 
library. If this parameter is not given* the new source 
library will be written to a file named RESULT. 



list I 1 s This Is a file to receive a report describing 
the conversion. The default value for this parameter is 
OUTPUT. 

name_l ist S nl s See discussion of name substitution 
above. 



1 
i 
3 
% 
S 
$ 



9 



I 

I 
I 
1 
% 
I 

lit 

lit 

112 

U3 

11* 

US 

16 

17 

19 

19 

2S 

21 

22 

29 

12% 

3 25 

zm 

2f 

28 

29 

130 

131 

32 

33 

I3t» 

J3S 

3 36 

3? 

3 38 

139 

Iif0 

hi 

ht 

IM» 

\kS 

kS 

\hl 
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3*0 COMMANDS 

3.4.1 CGNVERT_UPOATE_TO_SCU I CUTS 



brief I or 1 full I fu I If the BRIEF keyword is included 

on the command or this parameter is omitted* a shorter 

form of the listing will be produced- If the FULL 

keyword is used a more detailed listing Milt be 
produced* 

ascii64 I asci!812 s These alternate keywords inform the 
conversion routine whether the input program library is 
in the 64 character set or full ascii. ASCII812 is 
selected if neither keyword is given* Cur rently fh e 
conversion from ASC II update r (A5€|I?jLg? is, „ _fKffit 

ifolefentq*** 

criteria I cr s This is the name of a file to receive 
criteria file directives which will preserve a part of 
the information from the YANK$$$ deck on the UPDATE 
program library* Active YANK*s will be converted to the 
corresponding EXCLUOE's. Active DEFINE*s will be 
converted to DECLARERS* Inactive cards in the YANKSSS 
deck will be ignored* If this parameter is omitted the 
contents of the YANK$$$ deck will be ignored* 

status I st s See basic status concept. 

Example* 

scu*convert_update_to_scu plla scuplla saga ascii 64 



3. «f* 2 C0NVERT_M0DIFY_T0_SCU 5 CMTS 



This command 
source I ibrary* 



converts a MODIFY program library to an SCU 



convert__modi f y_to_.se u Copf = <l ocal _f II e_name> 1 

Cresul t=<f i le_name>1 
tl ist=<local_fl le_name>1 
Cname_l ist=<local_f i le_name>l 
tbrief I full! 
(ascii64 1 ascli6123 
£criterla=<local_f ile_name>1 
Cstatus=rllr2!r3Sef 1 

opl t This is the name of a file containing a MCOIFY 
program library* If this parameter is not given an 
attempt is made to access a local file named OPL* 

result 3 r 8 This is the file to receive the new source 

COMPANY PRIVATE 



I 

3 
% 



* 
9 

110 

111 

112 

111 

lft 

US 

lift 

II? 

US 

U9 

I2f 

S2f 

121 

23 

%Z% 

25 

126 

127 

2S 

29 

3f 

3f 

32 

33 

3* 

135 

83S 

3? 

38 

39 

40 

54i 

142 

48 

144 

145 

I4S 

4F 

14* 
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3,0 COMMANDS 

3.*. 2 CONVERT_MODIFY_TO_SCU 1 CMTS 



library. If this parameter is not given* the new source 
library will be written to a file named RESULT* 



list 1 I s This is a file to receive a report describing 
the conversion. The default value for this parameter is 
OUTPUT. 



name^list 3 nl 
above. 



See discussion of name substitution 



brief i tor 1 full 5 fu l If the BRIEF keyword is included 
on this command or this oarameter is omitted* a shorter 
listing will be produced. If the keyword FULL is 
included a more detailed listing will be produced. 

asciife* I ascii612 s These alternate keywords inform the 
conversion routine whether the input program library is 
in the 6* character set or full ascii. ASCII612 is 
selected if this parameter is omitted. 

criteria I cr s This is the name of a fife to receive 
criteria file directives. As an example* modifications 
flagged as yanked by MODIFY will be entered into the 
criteria file as EXCLU0E_M00 directives. 

status 1 st t See basic status concept. 

Example: 

scu.convert_modi f y_to_scu re I la scula saga ascii6* 



3. if. 3 CONVERT_SCU_TO_UPOATE 1 CSTU 

This command converts an SCU source library to an UFDATE 
program library. Th{s command j s not currently Implemented 
and t he requirement for such a command £s ung'er review, 

convert_scu__to_update £base=< f i le_name>l 

tnewpl = <locai_f il e_name>l 
CI ist=<local_f i le_name> 1 
£name_l ist=«l ocal_f i le_name>l 
Cbrief I fulll 
tascii812 I ascii6*l 

tcr i ter ia=< 1 oca I f i I e_name> 1 

Cstatus=rilr2lr3lef 1 

base 1 ba t This is the name of a file containing an SCU 
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1 1 

% 2 

f 

% 
1 5 

1 6 

I ■? 

9 

1 9 

lit 

11 

12 

13 

i* 

15 

16 

1? 

IS 

IS 

20 

21 

122 

123 

12* 

125 

26 

5 2* 

28 

129* 

138 

31 

32 

31 

3* 

135 

136 

13? 

38 

139 

1*9 

*1 

kt 

*i» 
i*s 

1*6 
*? 
*« 
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3.0 COMMANDS 

3. if. 3 CONVERT_SCU_TQ_UPOATE I CSTU 



source library to be converted* If this parameter is not 
given an attempt will be made to access a file named 
BASE. 

newpl s This is the file to receive the new UPDATE 
program I ibrary* If this parameter is net given, the net* 
program library will be written to a file named NEWPL. 

list 5 I s This is a file to receive a report describing 
the conversion. The default value for this parameter is 

OUTPUT. 

name_l ist 1 nl s See discussion of name substitution 

above* 

brief I br I full I fu s If the BRIEF keyword is included 
on the command or this pararmeter is oreitted* a shorter 
listing will be produced* If the FULL Keyword is 
included a more detailed listing will be given. 

ascii812 1 ascii6*» s These alternate Keywords inform the 
conversion routine whether the output program library is 
in the 6^ character set or full ascii. ASCII812 is used 
if this parameter is omitted. 

criteria 1 cr s This is the name of a criteria file. 
DECLARE directives will aooear as *DEFINE directives in 
the YANK$$$ decK on NEWPL* EXCLUDE directives will 
appear as *YANK *SELYANK and *YANKD£CK directives. 

status I st $ See basic status concept* 

Examples 

scu*convert_scu_to_update scupl la plla myth 



I 1 

% 

\ 5 

I 8 

I ? 

8 

I 9 

U® 

Ul 

12 

115 

US 

15 

16 

If 

18 

1% 

20 

21 

2* 

23 

Zh 

25 

5 26 

12* 

!28 

12* 

30 

131 

32 

5 33 

\Z% 

35 

36 

3? 

38 

39 

V0 

ht 

^2 

**3 

<»* 

**9 

*? 
^8 
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3.0 COHMANOS 

3*5 CALLING THE EDITOR 

3.5 CALLING THE EDITOR i 

2 

The command described in this section is used to call the I 

editor. All commands will be interpreted as editor commands * 

until one exits the editor. The editor can be used in either 5 

batch or interactive mode- 6 

7 

n 

9 

3.5.1 EDIT It 

II 

This command establishes an environment for the other line 12 

editor commands. II 

1% 
edit modif icat ion=<modif ication_name> 15 

£base=<f I1e_name>l ll€ 

Cresul t=<f il e_nam€>l lit 

I input=<locai_f i le_name>l 118 

II ist=<iocai_f ile_name>1 319 

iname=<deck_name> 3 I2f 

tcontlnuel 21 

tstatus=rl3r23r33efl 322 

23 
modification 3 mod : This is the name for the 25 
modification being Introduced or altered. 2$ 

26 
base I ba s This is the name of the file containing a 12? 
source library containing one or more decks to be 128 
edited. If this parameter is not given an attempt Is 329 
made to access a file with the name BASE* 338 

31 
result 3 r 2 This is the name of the file to receive the 132 
modified source library. If this is not given the 533 
modified library will be written to a file named RESULT. 335 

35 
input 1 i 5 This is the name of the file from which edit 36 
commands are to be read. The default value is INPUT. 3? 

38 
list I t t This is the name of the file which receives 39 
the listing. If this parameter is not given* the file 58 
name OUTPUT will fee used. 51 

52 
name 1 na s This is the name of the deck to edit first. 153 

55 
continue 8 con : If this keyword is present, the editor 355 
will allow the user to add to an existing modification in 156 
state 0. 35? 

58 
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3,0 COHHANOS 
3.5*1 EDIT 



status \ st t See basic status concept. ? I 

t 
Examples 1 3 

scu.edit improve oldpl continue ! H 



5 



9 
IS 
If 
12 
13 
1* 
15 
16 
1* 
19 
19 
29 
21 
2t 
21 
2% 
25 
26 
2? 
Z% 
2% 
38 
31 
3t 
33 
35 
35 
36 
3? 
3« 
39 
h9 
kl 
tf2 
%3 
*f«» 
kS 
k% 
if? 
<*« 
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3.0 COMMANDS 

3,6 GROUPING SCU COMMANDS 



3.6 fiRjgU£lMS ?CU Wffll&MflS 

Although SCU commands are available 
statements that may be used entirely 
another, it is often desirable to 
another to make a series of changes to 
and produce a single result source 



as separate lob control 

independently of one 

associate them with one 

a base source I Ibrary 

library and listable 



output. This is done by using the GROUP and END commands. 



3.6.1 GROUP 

This command is used to flag that following SCU commands 
are to be associated with one another and to assign default 
values for the names of some of the files that these commands 
must access. When this command is used the base source 
library is copied to a working copy. Subsequent SCU commands 
using the default base source library will modify this working 
copy. Using the END command causes the working copy to be 
written to the result source library, Nonde fault base and 
result source libraries may be named explicitly on individual 
commands. 

Permanent files named on the BASE and RESULT parameters on 
the GROUP command will remain local until the corresponding 
END command is executed. The commands listed above under 
conversion aids should not be used in group mode. 

group Cbase=<f ile_name>1 

tresul t=<f i le_name>l 

tl ist=<!ocal_f i 1 e_name>! 

Cstatus=rl3r23r3 3ef 1 

base 1 ba s This is the name of the file containing the 
base source library. If this parameter is not given an 
attempt is made to access a file with the name BASE. 



result Irs This is the file to receive 
source library. If this parameter is 
modified source library will be written to 
RESULT. 



the modified 
not given* the 
a f i le named 



list 1 I s This is the name of the file which receives 
the listing. If this parameter is not given, the file 
name OUTPUT will be used. 



Examples See example below under end. 



3 
* 
5 

1 6 

1 1 

1 8 

9 

1* 

It 

112 

13 

i* 

15 

16 

If 

19 

19 

1% 

21 

122 

\Z% 

32«» 

125 

%Z% 

12? 

28 

129 

»3» 

131 

3 32 

33 

13* 

5 35 

336 

3? 

3 38 

139 
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Iki 

hi 

US 
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1^5 
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3.0 COMMANDS 
3.6.1 GROUP 



3.6.2 END ** 

B 

This command causes the working copy of the source library 6 

to be written to the result source library file and any f 

subsequent SCU commands to operate independently of one 8 

another. 9 

if 

end £status=<status_variabie>] II 

12 
13 

Examples scu. group oidlib newlib Ist0212 51* 

scu.disp lay_l ibrary full !15 

attach, textfp. 16 

scu.create_deck < (fetch_parameters»textfp) ) .. lit 

fetch__p g=scu 118 

scu.create_modif icat ion mod_to_> au^'M. J. Perreten* • 119 

de=*Adds syntax check.* 2f 

scu.edit mod_to_J» continue i=edcoms $21 

scu.display_! ibrary alterna l=altlist 322 

scu.change_modi f icat ion axle stated 523 

scu« disolay_l ibrary full iZ% 

scu.end 125 

Zh 

In this example the GROUP command declares that the SCU 12? 

commands that follow will be associated with one another. 128 

0LDLI8 is the file which contains the base source library. 29 

All changes to this base are accumulated on a working copy ^nd 38 

will be written to the result source library NEWLIB when an 31 

END command is encountered. Displays will be written to the 3E 

file LST0212 unless another list file is explicitly named on 38 

an individual command. 3% 

The first DISPLAY_LIBRARY command gives a detailed 35 

description of the original source library. 3S 

The attach of file TEXTFP is shown to illustrate that ether 3? 

commands can be intermixed with SCU commands. 38 

The CREATE_0£CK command creates a new deck on the working 39 

copy of the source library using the contents of file TEXTFP **8 

as the initial text. HE 

The CREATE_MOOIFCATION command creates a new modification %& 

on the working source library. 4S 

The EDIT command calls the editor to perform the edit lk% 

commands from file EOCOMS on the working copy of the source IhB 

library. Lines introduced by this session will be part of the IkG 

modification mod_to_>. kV 

The second DISPLAY_LIBRARY command is included to emphasize *»8 
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3.0 COMMANDS 
3.6.2 END 

mm mm mm mm m m mm mm m» m m mm im mm mm mm mm mm mm mm mm-mm mm m m mm m m -mm -mm mm mm m m , m m m -mm mm ow » ****** m m mm -mm m m «» * i < w m m mm mm m m mm m m mm - mm mm mm mm mm mm mm m m mm mm ^ mm m m mm mm mm mm ■ 

that individual commands can explicitly name alternate files I 

to manipulate. i 

The CHAN€E_MOOIFC*TICN command raises the state of 3 

modification axle on the working source library to state h % 

(released). 5 

The fast DISPLAY_LI8RARY command gives a detailed 6 

description of the working source library after all the 9 

changes introduced by the entire block of SCU commands* 8 

The END command causes the working source library to be 9 

written to the result source library on file NEHLIB and flags ItJ 

that subsequent SCU commands will execute independently of one it 

another. 12 

13 
1% 
15 
16 
If 

in 

19 
29 
21 
22 
2i 
Zh 
25 
26 

zr 

28 
29 
3f 
3i 
32 
31 
3% 
35 
36 
3* 
38 
39 
V8 
kl 
kZ 
*♦! 
t*% 
<»5 
t»6 

^ 8 
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*».0 DIRECTIVES 



**0 OIREpTIVE? 1 

2 



Directives are available to the SCU user to assist him in f 
defining the contents of an expanded text file. These are 8 
text embedded directives intermixed with the source data and 9 
criteria file directives. This section describes both types 10 
of directives and their interaction with one another. II 

12 
IS 

15 
A text embedded directive <TED) will be recognized by the 16 
occurrence of a key character as ihe first character of a 1? 
source line followed immediately by a Keyword. If a TEO is 1* 
encountered the normal expansion will be altered it> the 19 

aiannner specified by the particular TED. 20 

2f 

While processing the EXPAND_OECK command, TEO's are 22 

processed and they are not copied into the expanded text 23 

file. While processing the EXTRACT_QECK command, TED*s are 2% 

not processed and are written to the the extracted text file. 25 

26 

2? 

28 

4.1.1 COPY 29 

38 
This directive must be followed by a deck name. This 31 
directive will copy the text of the specified deck into the 32 
expanded text file. The same search order will be used as for 33 
decks listed on the EXPAND__OECK command. A deck may copy a 3i» 
deck that copies another deck and so on as long as the 35 
sequence is not recursive. 36 

3? 
*copy name=<deck_name> 138 

39 
name I na s This is the name of a deck. Alternatively a ihd 
list of names may be given separated by commas and IV! 
enclosed in parentheses. IV2 

Examples *cooy deckl M» 

kS 
kh 
*♦? 
t*8 
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k. 1.2 COPYC (COPY CONDITIONAL) 

This directive serves the same function as COPY except that 
the text of the deck is written to the expanded text file 
conditionally. In other words* if the specified deck has been 
copied into the expanded text file for the deck currently 
being expanded* it will not be included again* 



Alternatively a 

by commas and 



*copyc name=<deck_narae> 

name I na i This is the name of a deck, 
list of names may be given separated 
enclosed in parentheses. 

Examples *copyc deck! 



<*.1.3 DECK 

This text embedded directive will only be interpreted as 
such when it occurs as the first line of a partition t record 
on NOS 170) in the file named by the NAMES_CN_FILE parameter 
of the create deck command. Its purpose is to provide the 
deck name for the following text lines. 

♦deck name=<deck_name> C expand I no^expand] 



name * na 
which will 
direct ive. 



s This is the name to be given to the deck 
contain the text lines that follow the 



expand 1 exp I no_expand I nexp s If the N0_EXPAN0 
keyword is included on the directive this deck will only 
be written to the expanded text file produced by the 
EXPAN0_0ECK command as a result of processing the text 
embedded directives *COPY and *COPYC. If the EXPAND 
keyword is included or this parameter is omitted 
entirely* this deck will be written to the expanded text 
file by the EXPAN0_0ECK command whether named on the 
command or on the *C0PY and *C0PYC directives. 



*♦.!.** ELSE 

This optional directive may be used to separate lines of 
source data that are to be expanded if the given condition Is 
true from those expanded if it Is false. Either of the blocks 
between the IF and the ELSE or between the ELSE and the IFEND 



1 

2 

3 

* 

5 

f 

? 

8 

3 9 

IS 

lit 

112 

113 

1* 

15 

16 

1? 

US 

19 

I2B 

121 

122 

123 

\Z\ 

23 

126 

27 

128 

129 

139 

31 

131 

133 

I3S 

135 

136 

13? 

!3« 

139 

!<*§ 

Wt 

kZ 

<*3 

t*h 

k5 

t*G 

kit 
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may be empty. 



4.1.5 IF 

This directiv 
to the expanded t 
condition is true 
the next ELSE or 
be written to 
directives in t 
processing the 
present before th 
directives will 
directives. 



e is used to allow s 
ext file conditions 
• the source lines b 
IFEND directive <whi 
the expanded tex 
he same range wil 
EXPAND_OECK command. 
e IFEND the source I 
be skipped as we 



ource lines to be written 
lly. If the specified 
etween this directive and 
chever occurs first) will 
t file* Text embedded 

I be processed while 
If an ELSE directive is 

ines between those two 

I I as anv text embedded 



text 



If the specified condition is false, source lines and 
embedded directives will be skipped until either an ELSE or 
IFEND directive is encountered. Source lines 
embedded directives between a following ELSE 
processed. Normal < unconditional ) processing 
following the IFEND whether the condition is 



and text 
IFEND will be 
resumes 
true or false. 



There are two forms of this directive shown below, 
♦if $scu_type(name» type) 



name i This is a name to be checked 
attribute described in the type field* 



for the 



type s This field is used to specify one of three 
keywords. Any of these keywords may be prefixed by 
NOT. The keywords ares 



DECK 



MOD 



DECL 



This is a name of a deck on any of 
libraries specified by the 
parameter. 



This is the name of 
of the libraries 
parameter. 



a modification to 
specified by the 



the 
BASE 



any 
BASE 



This is a name defined by 
directive on the criteria file 
with this EXPAND^DECK command. 



a DECLARE 
associated 



3 

€ 

U 

I 8 

1 9 

119 

if 

it 

13 

1*» 

15 

16 

1? 

IS 

19 

21 

2t 

22 

23 

2% 

25 

26 

2? 

26 

29 

38 

31 

132 

133 

13* 

35 

136 

13? 

136 

39 

J 49 

14* 

142 

43 

45 

45 

46 

4t 

46 
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Example: *if $scu_type(dsd*deck> I 

These source lines are expanded if dsd 2 

is a deck name. 3 

*else 4 

These source tines are expanded if dsd 5 

is not a deck name and these source 6 

lines are skipped if dsd is a deck name* ? 

♦ifend 8 

Unconditional processing resumes with 9 

these source lines* It 

If 
Example 2s *if $scu_type C f ix2,notmod) 12 

These lines are expanded if there Is no II 

modification to the source library with 1% 

the name fix2. 15 

♦ifend IB 

!1? 
*if $rolname,value) I IB 

19 
name * This is a name defined by a DECLARE directive 2® 
on the criteria file associated with this 21 
EXPAND_DECK command. Testing a name that is not 22 
OECLAREd will cause an error. 23 

2% 
ro t This is a relational operator, acceptable 25 
values ares 28 

2? 
gt s Greater than. ?2B 

129 
ge s Greater than or equal to. I3S 

S31 
It s Less than. 131 

131 
le s Less than or equal. 13$ 

135 
eq s Equal to. 136 

13? 
ne s Not Equal tom I3B 

39 
value s This is a positive decimal value between tf 40 
and 65535. 41 

42 

Examples *if $ne < fritz, 35) 143 

These lines will be expanded if the name 44 

fritz has any value other than 35. 45 

•ifend 46 

4? 
Conditional blocks may be nested to a maximum depth of 32 148 
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levels with the restriction that every IF must have a watching 1 1 
IFENO within the same deck, 2 

3 
4 

4.1.6 IFENO 5 

6 

This directive marks the end of a block of smirce text to f 

be expanded conditionally* An IFENO must occur in the same 8 

deck as the corresponding IF. 9 

10 
It 

4.1.7 TEXT 12 

13 

This directive may tee used to indicate that the following 1% 

block of source data i s to be considered as text. In other 15 

words no scan will be made for text embedded directives except 18 

for TEXTEND. 17 

18 

19 

«f. 1.8 TEXTENO 20 

21 

This directive tells SCU to resume scaning source data for 22 

text embedded directives. 23 

25 
25 

4.1.9 WEOP 26 

27 

This directive will cause an end of partition to be written 2$ 

on the file receiving the expanded text. i In the NOS 170 129 

implementation of SCU* an end of record will be written.) 130 

31 
32 

4.1.10 WEOPC 333 

3* 
This directive will cause an end of partition to be written 35 
to the file receiving the expanded text, if any source datar 36 
has been written to the file since the last separator. <In I3f 
the Cyber 170 implementation, an end of record will be 138 
written.) 139 

40 
41 
42 
43 
44 
45 
46 
4? 
48 
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k.Z CRITERIA FILE DIRECTIVES 

h*2 CRITERIA FILE DIRECTIVES i 

2 
These directives are available to allow the SCU user to be 3 
more selective about what source data is written to the £ 
expanded text file. They are given on a separate file and are 5 
not preceded by a key character. They are processed in order 3 6 
of occurence. ! ? 

8 

9 

*».2.1 DECLARE 18 

II 

This directive is used to define a name with a value 12 

associated with it that can be used in connection with the IF 13 

text embedded, directive to conditonaily include source data on m 

the expanded text file, 15 

16 
declare name =<name> [ value=<integer> 1 I If 

18 
name % na s This is a 1 to 31 character name. 119 

2f 
value 5 This optional parameter is an integer in the 21 
range to 65535 decimal. If this is omitted the value 22 
is assigned. 21 

2* 
Examples declare fritz 35 25 

26 

2? 

^.2.2 EXCLUDE_DECK 28 

29 

This directive can be used to explicitly exclude a 38 

particular deck from being written to the expanded text file. 31 

32 
exclude_deck name=<deck__name> 133 

3* 
name 1 na s This is the name of a deck to be excluded* 135 
Alternatively a list of names separated by commas and 36 
enclosed by parentheses may be given or a range of decks 3? 
may be indicated by giving the first and last deck names 38 
to exclude separated by ellipses. 39 

kt 

^.2.3 EXCLU DEFEATURE <*3 

This directive is used to exclude incomplete or unstable \kB 

features from an expanded text file. 1^6 

h? 
exclude_feature f eature=<feature_name> f state=<integer> J :<*8 
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I 
feature 5 fe s This is the name of a feature to exclude ! t 
when generating an expanded text file. Alternatively a * 3 
list of features may be given separated by commas and % 
enclosed in parentheses. 5 

6 
state 8 This parameter may be given as one of five f 
integers 0-** 8 

(see states in the concepts section). All modifications 9 
which are part of this feature which are at or below the 10 

given state will be excluded from the expanded text If 
file. If this parameter is omitted all modifications 12 
associated with this feature will be excluded. 11 

1% 
Examples exclude^ feature new__network_interf ace 15 

IS 

1? 

t».2.i> EXCLUDE_GROUP IB 

19 

This directive is used to exclude an entire group of 20 

related decks from the expanded text file. 21 

Zt 
exclude_group group=<group_name> 123 

2* 
group I g s This is a 1 to 31 character group name* 125 

Alternatively a list of group names may be given 126 

separated by commas and enclosed in parentheses or a 12? 

range of groups may be indicated by giving the first and 328 

last group names to exclude separated by ellipses. 129 

30 

31 

*.2.5 EXCLU0E_M00 32 

33 

This directive can be used to exclude the effects of a 3* 

particular modification. 35 

36 
exclude_raod modi f icat ion*<modlf ication_name> •«! 131 
tname=deck_namel 138 

39 
modification i mod i This is the name of a modification l«tf 
to be excluded from the expanded text file. ?*»t 
Alternatively a list of modifications may be given V$ 
separated by commas and enclosed in parentheses. h% 

name I na ? This is the name of a deck. That part of the iUB 

modification which applies to this deck will be excluded J«»6 

on the expanded text file. Alternatively a list of deck V? 

names may be given separated by commas and enclosed in h% 
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parentheses. i 

2 
Examples excf ude_mod newmethod obsolete_deck 3 

5 

*.2.6 EXCLUDE_STATE 6 

7 

This directive is used to exclude the effects of all 8 

modifications at or below a given state. 9 

18 
exclude_state state=<integer> 111 

12 
state * This parameter is given as one of the integers II 
0-3 • 1* 

15 

16 

*.2.7 INCLUO£_COPYING_ DECKS 117 

18 

This directive causes all decks which copy a named deck to 119 

be written to the expanded text file. Chains of indirect 12 1 

references will be followed until decks with the EXPAND tZt 

attribute are found. 122 

23 
include_copying_decks name=<deck_name> 12* 

25 
name I na s This is a deck name. As on the £XPAND_DECK 126 

command the name parameter may be given as a list or 12? 

range of decks. 128 

29 

39 

*.2.8 INCLUDE.. DECK 31 

32 

This directive is used to specifcally include a particular 131 

deck on the expanded text file. I3*» 

35 
include deck name=<deck_name> 136 

3? 
name I na s This is a deck name. As on the EXPANO_D£CK 138 

command the name parameter may be given as a list or 139 

range of decks. 1*0 

*1 

*2 

*.2.9 INCLUDE_FEATURE h% 

This directive is used to include aM the modifications hS 
associated with a feature which are at a given state or higher *€ 
on the expanded text file. «•>? 

*8 
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include f eature=<f eature_na«e> lstate=<integer> 1 5 1 

2 
feature I fe s This is the name of a feature to foe 1 3 
included. Alternatively a list of features may be given i h 
separated by commas and enclosed in parentheses* 5 

6 
state t This optional parameter is given as one of five F 
integers 0-4 (see states in the concept section). If 3 S 
this parameter is omitted all modifications associated I 9 
with this feature will be included* lit) 

11 
Example: inc I ude_ feature new_net**ork_interface 3 12 

13 
1* 

4.2.10 INCLU0E_GR0UP 15 

IS 

This directive is used to cause an entire group of related 17 

decks to be included on the expanded text file. IS 

19 
include_group group=<group_name> 129 

21 
group I g s This is a 1 to 31 character group name. 122 

Alternatively a list of group names may be given 123 

separated by commas and enclosed in parentheses or a 1 12% 

range of groups may be indicated by giving the first and 125 

last group names to include separated by ellipses. 126 

2F 
23 

4.2.11 INCLUDE_MOO 29 

38 

This directive is used to explicitly include a modification 31 

in the expanded text file. 32 

33 
include_mod raodif ication=<modif lcation_name> •• 135 
Cname=<deck_name>] 135 

36 
modification I mod t This is the name of a modification 13? 
to be included. Alternatively a list of modifications my 13$ 
be given separated by commas and enclosed in 39 
parentheses. 40 

41 
name I na s This is the name of a deck. If this 142 
parameter is given only that part of the modification 143 
that applies to this deck will be included. As on the 4* 
EXPAND_0£CK command the name parameter may be given as a 45 
list or range of decks. 46 

4? 
Examples include_mod accounting^ ixes Ml 
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1 
2 
3 

*».2.I2 INCLUOE_STATE % 

5 
This directive is used to include the effects of all % 

modifications at or above a given state. f 

8 

inciude_state state=<integer> I 9 

It 
state I This parameter is given as one of the integers It 
0-**. 12 

13 
1* 
15 
16 
IF 
18 
19 
28 
2f 
22 
23 
2* 
25 
26 
2? 
28 
29 
3 8 
31 
32 
33 
3* 
35 
36 
3? 
38 
39 
*»t 

kZ 

1*5 
<*6 

<♦? 
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5.0 SCU EDITOR 1 

2 



5 

6 

The SCU editor provides the capability of generating and 1 

manipulating source text. It operates on files in source 8 

library format allowing source lines to be introduced or 9 

corrected either interactively or in batch mode* 10 

It 
12 

1* 

This section introduces some concepts that are used in the 15 

SCU editor. Although most of the terms are not new they may 16 

have particular meaning in the SCU context. 17 

liB 
19 

5.1.1 TABBING 2§ 

21 
The TAB command defines a tab character and associated tab 122 
columns. Other commands which involve inserting text scan the 23 
inserted text for the tab character* When the tab character 2*» 
is encountered* spaces are inserted into the text from that 25 
point up to the next tab column where the next character is 12$ 
placed. The tab character is not placed in the library text. 12? 
One can define a default value for the tab character and 128 
columns in each deck header. 29 

30 

One tab character and up 256 associated tab columns can be 31 

active at one time* 32 

33 

3* 

5.1.2 LINE IDENTIFIERS 35 

36 

Each line within an SCU library is assigned a line I3f 

identifier which Is unique within a deck. This identifier 138 

consists of the 1 to 9 character modification name and a six 39 

digit sequence number. The sequence number will start from 1 b® 

as the first line introduced under the modification in a deck kl 

and increment by 1 as lines are added. Continuing a ht 

modification will result in sequence numbers starting 1 *i3 

greater than the last previously introduced to this deck. H% 

Sequencing starts from l in each deck rather than being ^5 

continuous throughout the source library* To reference a line *»6 

by line identifier one gives the modification name separated bl 

from the sequence number by a period* Trailing blanks in the **% 
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modification name and leading zeros in the sequence numbers I 
will have no significance. 2 

i 

5.1.3 KEYWORD VALUES 5 

€ 

On some editor commands, lines or position within a deck 1 ? 

may be given through the use of keywords. These keywords and 1 8 

their short forms are listed below. 9 

10 
ALL 1 A s This indicates all active lines in an SCU lit 
deck. 112 

13 
FIRST 1 F % This indicates the first active line in an 11% 
SCU deck. 115 

16 
LAST ? L ? This indicates the last active line in an SCU 51? 
deck. 118 

19 
CURRENT % C i This indicates the current active line in 828 
an SCU deck. 121 

22 
On those line editor commands using the number parameter the 2$ 
keyword below can also be used to specify a value. 2* 

25 
ALL 1 A % This specifies every active line in a range. 126 

21 
On those line editor commands using the occurrence parameter, 128 
the keyword below can be used to specify a value. 129 

3 
LAST 1 L i This specifies the last occurrence of the line 131 
or block. 132 

33 
On the DECK command a deck to be edited can be selected by 13% 
giving a deck name explicitly or by the use of the keywords 135 
below. 136 

3? 
FIRST s This keyword selects the first deck in the 138 
directory on the library as the object of the commands 139 
which f ol low. 1*»® 

ht 
LAST s This keyword selects the last deck in the l**2 
directory on the library as the object of the commands 1*»3 
which follow. !*♦*» 

k$ 
NEXT t This command selects the next deck in the !**6 
directory on the library as the object of the commands Ik? 
which f ol low. 1**8 
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5.1. <» WIOTH 

Width is a maximum number of characters to be allowed in a 
text fine. Line overflow occurs if the user causes a line to 
be longer than the width declared. The editor issues a 
warning message and allows the overflowing line to be added or 
altered. It is the user's responsibility to split longer 
I ines where necessary. 



1 1 
2 



5.1.5 THE BATCH USER 

The SCU line editor 
batch and interactive 
not be available to b 
which commands and opt 
prove desirable. For 
I ines by matching t 
which is readily appar 
cause serious proble 
mode. 



will in some cases discriminate between 
users. The VETO option on commands will 
atch users. Further restrictions on 
ions are available to the batch user may 
example* locating or altering source 
ext strings alone may lead to ambiguity 
ent when editing interactively but may 
ms when entering corrections in batch 



5.1.6 UNIT 

Some of the line editor commands use as a parameter the 
UNIT keyword* which has the short form UN. When this option 
is selected a text string will be considered a match with that 
given on the command only if it occurs as a unit, that is it 
is surrounded by characters other than those allowed in an SCL 
name. The most common example of this is to search for a 
character string that is enclosed in a pair of blanks. 



5.1.7 VETO 

Some of the line editor commands that involv 
source line alteration allow the keyword parameter 
has the short form V. If this parameter is spec 
first and last line of each group to be altered wil 
followed by the query "CHANGE?", "OELETE?" or 
depending on the command. In the case of the CHA 
the candidate line will be shown with the n 
substitution already in effect. The user may 
following responses to the querys 



e text or 

VETO which 

ified, the 

I be output 

"REPLACE?" 

NGE command 

ext string 

make the 



NO 1 N s This causes the current group replacement 
skipped. 



to be 



% 
5 

6 
F 
8 
9 
10 
11 
12 
13 
1* 
15 
16 
If 
IS 
19 
28 
21 
22 
23 
Zh 
25 
26 
2* 
28 
29 
38 
31 
32 
33 
3* 
35 
36 
37 
138 
139 

im 

\hZ 
SU3 
1M» 
?*f5 

us 

V7 
«»8 
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1 

QUIT I Q f This causes the command to terminate with no 2 

further replacements. 3 

CONTINUE I C 3 This causes veto mode to be ended. The 5 
current and any subsequent replacements wilt occur. 6 

? 
YES I Y s This causes the current group replacement to 8 
take place. 9 

If 
Any other response causes the query to be repeated and It 
veto mode to remain in effect. 12 

13 
Ik 
15 
IS 

5.1.8 ENO OF LINE BLANKS 17 

18 

The SCU editor deletes trailing blanks on input. For the 119 

sake of matching character strings during searches lines 128 

appear to be blank padded to "width** characters. 121 

22 
23 

5.1.9 TERMINAL INTERRUPTS ?2% 

25 
Under IAF on 170 either user break I or user break 2 wil I* 126 
have the same effect on the editor. If either is received 12? 
while displays are being sent to the terminal the remainder of 328 
the output will be discarded and the editor will wait for a 129 
new command to be entered. If either is entered while the 130 
editor is waiting for a response to the veto query described 131 
above the editor will respond as if the user had entered 532 
QUIT. If either is entered while the editor is accepting text 133 
input* text input mode will be ended. In the last case an I3H 
additional carriage return will be required before the user 135 
will be able to continue. 136 

3? 

39 

5.1.10 REPLACEMENT TEXT 139 

On the INSERT and REPLACE commands described below I VI 

replacement text may be supplied in three different ways each IVZ 

indicated by the use of a different keyword. Tab characters 1«*3 

are processed regardless of the origin of the replacement iv% 

text. Lines introduced will have line identifiers consisting 1^5 

of the current modification name and consecutive sequence !«»6 

numbers starting from the current value of the sequence number IkW 

for this modification. The replacement text parameter is IV8 
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5,0 SCU EDITOR 

5.1. 10 REPLACEMENT TEXT 



described below: i i 

2 
tuntil=d?wl th=t3f file=<local_f i1e_na?ne>1 3 I 

until S u s When the keyword UNTIL is used, replacement I 5 
text is read from the edit command input file. The one I 6 

character string given as the value of this parameter I 7 
specifies the delimiter marking the end of the text to be I 8 
inserted. The delimiter is only interpreted as such when I 9 
it is the last character on a line. The delimiter is not I 10 
considered part of the entered text. Ill 

12 
with 3 w s When the with keyword is used, the string 113 
given as the value for this parameter is used as the 11^ 
replacement text. 115 

16 
file t f s When the file keyword is used, replacement 117 
text is read from the named file. If the keyword FILE is II* 
used and no value is given an attempt is made to access a 119 
file named MERGE. When this keyword is used the keywords 128 
below can be used as the second value of a value set for 121 
this parameter. 122 

23 
rewind I r 1 rewind_bef ore 1 rb I rewlnd_after I ra I2*» 
J no_rewind I nr These keywords specify positioning 125 
to be done on the file. Default is REWIND_BEFORE. 126 

2? 
Default values are assigned as follows. If the the 12S 

value of this parameter is given posltionally, it is 129 
assumed to be a value for WITH. If this parameter is 130 
omitted entirely the command will be processed as if 131 
UNTIL=*/* had been specified. 132 

31 

3% 

5.2 EDIT OR COMMANDS 35 

36 
The SCU line editor commands employ a syntax similar to 137 
that proposed for NOS/VE System Command Language (SCLK Nhere I3S 
ranges are Indicated* such as first and last lines to be 139 
listed, the two values are separated by ellipses. Items shown k$ 
in brackets are optional and those nested in brackets within kt 
brackets are an optional part of an optional item. **2 

*f3 

The short form for a command is given with the command %% 

where one is available. hS 

<t6 
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5*2,1 CHANGE I C 

5*2.1 CHANGE I C t 

2 

This changes a specified number of occurrences of a 13 

specified string to a replacement string. I *» 

5 
change text-tl twith=t33 £number=n 3 C 1 ines~1 1C* • 1 23 ] lunitl *. I % 
tvetoJ % ? 

8 
text I t s This specifies the text string which is to be 19 
replaced on lines in the range given below* Hi 

11 
with 1 w $ This specifies the text string which will 12 
replace the one searched for in the previous parameter* 13 
If this parameter is omitted the original text string 1% 
wil I be deleted* 15 

16 
number In 8 This specifies the maximum number of If 
occurences of the original string that are to be 118 
replaced* The value of this parameter may be given as a 119 
number or the keyword ALL* This defaults to ALL if a 128 
range is given explicitly for the lines parameter and to %ZX 
1 occurence when it is not. 22 

23 
lines I I s This specifies the range of lines to be 12*i 
scanned for string substitution. The value of II may be S25 
given as a line identifier or one of the keywords ALL* 126 
FIRST, CURRENT or LAST. The value of 12 may be given as 12? 
a line identifier or the keyword CURRENT or LAST* If 128 
this parameter is omitted II and 12 are given the default 129 
values of CURRENT and LAST respectively* 30 

31 
unit 1 un 5 See description of unit above* 132 

31 
veto 1 v 8 See description of veto above* Also for this 3$ 
command, should the string to be replaced occur more than 35 
once in a line, the veto option will cause the line to be 36 
displayed once for each potential replacement with the 3? 
next replacement in effect* 38 

39 
Example: change •Bill* "Sam" l=decka. 153. .LAST 3«*8 

hi 

The command above will replace every occurence of the text %hZ 

string •Bill* with the text string "Sam* on each line in the 1^3 

deck currently being edited from the line with the identifier ihh 

decka.153 to the last active line in the deck. 5**5 

<♦? 

«*• 
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5.2.2 CLEARTAB I CTAB 1 

This clears tabbing selections defined by a TAB command. 5 

H 
cleartab f columns=cl. c2. ..cnl 5 

6 
columns I col s This parameter is a list of tab columns I f 
to be cleared. If this parameter is not given, alt 5 8 
columns are cleared. I 9 

10 
il 

5.2.3 COPY 112 

13 

This copies a group of tines from an library to a local 114 

file. The copied lines are left unaltered in the original 215 

location* 116 

If 

copy ttext=ti£.. t23 3 C f i le={<local_f i le_name> 118 

C*rewindlrewind_bef orelrewind_af ter lno_rewindJ) 1 .. 119 

Clines=lii..l233 tnumber=n3 Cunlt] 128 

21 
text I t s This specifies strings of text occurring in 22 
the first and last lines of text to be copied. If this 23 
parameter is omitted entirely, the lines parameter Mil • 2% 
determine the lines to be copied. If a single text 25 
string is given. a group to be copied will contain a 26 
single line. When two text strings are given* the search Z¥ 
for the second starts immediately after the occurrence of 28 
the first. 29 

3 8 
file I f 3 This is the name of a local file to which the 131 
text of the selected lines will be written. If this 132 
parameter is omitted the text lines will be written to a 13§ 
file named MERGE. The Keywords below can be used as the 134 
second value of a value set for this parameter. 335 

36 
rewind I r 1 rewind_bef ore I rb I rewind_af ter I ra 13? 
1 no_rewind 1 nr s 138 

This parameter specifies positioning for the local 139 
file. Omission causes the file to be rewound before 140 
it is written. 141 

42 
number 1 n : This specifies the maximum number of groups 43 
of lines to be copied. Number specifies the count of 44 
occurrences of the copied block when the text parameter 45 
is given and individual lines when it is not. This 46 
parameter may have its value given as a number or the 147 
keyword ALL. This parameter defaults to ALL when a range 148 
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is given explicitly for the lines parameter and to 1 when I 1 
it is not. 1 2 

5 
lines 1 I s This specifies a range of lines to be scanned % H 
for copying* II can be a line identifier or the keyword I 5 
ALL, FIRST, CURRENT or LAST. 12 may be given as a line i 6 
identifier or the keyword CURRENT or LAST. The default I ? 
values supplied i f no range is given explicitly for the 1 8 
lines parameter are CURRENT and LAST respectively. ! 9 

10 
unit J un s See description of unit above. 111 

12 
Examples copy l=abc.*». .abc.63 113 

1% 

In this example the text lines abc.tf through abc.63 will be 515 

copied out to a file called MERGE. 116 

If 

18 

19 

5.2.*» DECK 128 

2f 

This command names the deck to which the following edit 122 

commands are to apply. 128 

2* 
deck name=deck name I first Inext Hast 125 

26 
name I na % first S next 3 last : When the keyword NAME 12? 

128 
5 29 
130 
131 



name » na * i 1 1 3» i * iicai « iaai • nn*=n i i»« c\ct«wi vj n«ri«» 

or NA is used or a value only is given this specifies the 
name of the deck to be edited. The alternative keywords 
FIRST, NEXT and LAST can be used to select the decks 

whlrh /*#*•/»!»*» in + t*neo nncJ + lrtnc 1 r\ tha Hlpor+nrv or* thA 



which occur in those positions in the directory on the 
library. 5 32 

33 
Examples deck dsd 3*i 

35 

36 

3? 

5.2.5 DELETE 5 D 38 

39 
This deletes specified lines from the current deck. ihH 

%f 
delete t text=tll. .t2 ] ] tnumber=n] £ I ines = l It . .1211 lunitl •• U2 
tvetol IV3 

text I t * This specifies strings of text occurring in hS 

the first and last lines of text to be deleted. If this «*6 

parameter is omitted entirely, the lines parameter wilt **7 

determine the lines to be deleted. If a single text V8 
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5*0 SCU EDITOR 
5*2.5 DELETE 3 



string is given* a group to be deleted will contain a 
single line. When two text strings are given* the search 
for the second starts immediately after the occurrence of 
the first. 

number I n * This specifies the maximum number of groups 
of lines to be deleted* Number specifies the count of 
occurrences of matching blocks when the text parameter is 
given and individual lines when it is not* This 
parameter may have its value given as a number or the 
keyword ALL* This parameter defaults to ALL when a range 
is given explicitly for the lines parameter and to i Mhen 
it is not* 

lines I I t This specifies a range of lines to be scanned 
for deleting* II can be a line identifier or the keyword 
ALL* FIRST, CURRENT or LAST* 12 may be given as a line 
identifier or the keyword CURRENT or LAST. The default 
values supplied if no range is given are CURRENT and LAST 
respectively* 

unit ? un J See description of unit above* 

veto 3 v s See description of veto above. 

Examples: delete "This line has a four letter word** l=all 

d 



The first example deletes all lines 
which contain the indicated string* 
deletes the current line* 



in the current deck 
The second example 



5*2.6 DISPLAY_EDITOR_STATUS ? DES 

This command displays the name of the file being edited* 
the modification name in use. the deck being edited* the 
currently selected width, the current tab character and 
columns, what window columns are in effect and whether the 
verify and state options are active* 

display_edi tor^status 



I 

k 

5 

6 

F 

8 

9 

US 

Ml 

112 

U3 

1* 
115 
US 
II? 
MS 
119 
I2f 

Zt 
122 

23 
\Zh 

25 
126 
32? 

28 
129 
13® 
131 

32 

31 
\Z% 

35 
136 
137 
138 

39 

<t8 

W\ 
\k% 

Wh 
«f5 

^6 

h? 
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5.2.7 END 

5.2.7 END t 

Z 
This command terminates the line editor. 3 

h 
5 

5.2.8 FIND I F 6 

7 

This finds a specified block of text in the current deck 1 8 

and updates the current position within the deck. If the f 9 

verify option is selected the first and last lines in the 110 

block will be displayed or the line will be displayed if a 111 

single line is sought. 112 

13 

find ttext=tit..t21 1 { occurrence^© J C I ines=ll £..! 211 Cunitl U«* 

15 

text ! t x This specifies strings of text occurring in 18 

the first and last lines of fh% block of text to be 11 

found. If this parameter is omitted entirely* the lines 18 

parameter will determine the line to be found* If a 19 

single text string is given* the block to be found will 20 

contain a single line. When two text strings are given* 21 

the search for the second starts immediately after the 22 

occurrence of the first. 28 

2% 

occurrence 5 o : Occurrence specifies the count of 125 

occurrences of the matching block when the text parameter 126 

is given and single lines when it is not. Occurrence ?2? 

specifies that the oth occurrence of the line or block is 128 

to be found. The value of this parameter may be given as 129 

a number or the keyword LAST. The value of this 130 

parameter defaults to 1. When o is negative* the oth 331 

previous occurence of the line or block will be found 132 

starting with II from the lines parameter and scanning 333 

towards FIRST. 35 

35 

lines 1 I s This specifies a range of lines to be scanned 336 

for the find. II may be given as a line Identifier on 13? 

the keyword ALL, FIRST* CURRENT or LAST. 12 may be civen 138 

as a line identifier or the keyword CURRENT or LAST. 11 S39 

defaults to CURRENT and 12 defaults to LAST if the lines !*♦§ 

parameter is omitted entirely. If the value of the t<*l 

occurrence parameter Is negative* 12 may not be given and l*>2 

the search is backwards from II to FIRST. 3**3 

unit 1 un t See description of unit above. \hS 

h% 
Example: f 'title - -1 |i»7 
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5.2.8 FIND 5 F 

In this example the SCU editor wilt start from the current J f 
line and then search for the nearest previous line which 2 
includes the text string "title*. S 

h 

5 

5.2.9 INSERT J I 6 

? 

This command inserts text after or before the specified I $ 

line. i 9 

IB 
insert Cunt i l=dlwith=t 31 f i f e=<name>3 Cat ter=l ilbef ore=l i ] .. Ill 
Isingle_partitionlmul t impart it Ion 1 f 12 

13 
until I u I with I n I file I f s See discussion of II* 
replacement text above. *15 

16 
after I at I before 1 be : This specifies the line text II? 

is to be inserted after or before. This parameter may JIB 
have its value given as a line identifier or one of the 119 

keyword FIRST* CURRENT or LAST. The default value for !2tJ 
this parameter is after CURRENT, 121 

22 
single_partition I so 1 mult impart it ion I mp ? This 123 
parameter is only meaningful when the FILE keyword is %Z% 
used to indicate the source of replacement text. If the IZS 

MULTI_PARTlTION keyword is included on this command* each 126 
end of record encountered in the merge file will be 12? 
represented on the source library as a *WEOP text S2S 
embedded directive. If the SINGLE_PARTITION keyword is 529 
used or this parameter is omitted entirely* only the text I3S 
before the first separator on the source file will be 13-i 
represented on the source library. 132 

33 

Example is insert af~bill.l<» 33<» 

This line is inserted after bill line lh./ 135 

36 
Example 2s i "CBrief inane comment.!" S3? 

38 

In this example the replacement text was given on the 139 

command. !*»§ 

<*t 
WZ 
<f3 
h% 
t*5 
kh 

**B 
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5.2.10 LIST I L 

5*2.10 LIST 1 L I 

2 

This lists specified blocks of lines from the current 1 3 

deck* 1 5 

5 
list ttext=tlt.*t2I1 tnumber=nl £ I Ines=l It .. I 23 1 tunitl % 6 

7 
text I t s This specifies strings of text occurring in 8 
the first and last lines of the block of text to be 9 
listed* If this parameter is omitted entirely* the lines IS 
parameter will determine the lines to be listed* If a 11 
single text string is given* the block to be listed will 12 
contain a single line* When two text strings are given* 13 
the search for the second starts immediately after the 1% 
occurrence of the first* 15 

16 
number I n s This specifies the maximum number of groups If 
of lines to be listed. Number specifies the count of 18 
matching blocks when the text parameter is given and 19 
individual lines when it is not* This parameter may have 29 
its value given as a number or the keyword ALL* This 21 
parameter defaults to ALL when a range is given by the ZZ 
lines parameter and to 1 when no range is given* 23 

25 
lines 1 1 s This specifies the range cf lines to be 25 
listed* A value for 11 may be given as a line identifier 26 
or one of the keywords ALL* FIRST, CURRENT or LAST* A 127 
value for 12 may be given as a line identifier or the 128 
keyword CURRENT or LAST. If this parameter is omitted, 529 
11 defaults to CURRENT and 12 defaults to LAST* 138 

31 
unit ? un : See description of unit above. 132 

33 

Examples f n=5 35 

This lists 5 lines starting with the current line* 35 

36 

37 

5*2*11 MASK 538 

39 

This command defines a character which will be considered 159 

as matching any character during string searches or clears the 151 

selection of such a character. 152 

53 
mask characters S of f 155 

55 
character 1 c 1 off * If the OFF keyword is used, masking 5 56 
will be turned off. If the CHARACTER keyword Is used or 15f 
no keyword is used, this must be a one character string 158 
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5.0 SCU EDITOR 
5.2.11 MASK 

specifying the character which is to be used to match all 11 

characters in string searches- S 2 

3 

Examples Mask •»• I % 

change *P*rr*t*r\ m "Perreten* I 5 

6 

In this example all vowels in the name Ferret en are e - s* I f 

These commands will correct all misspellings of the name in I 8 

the current deck which match the pattern given by the TEXT I 9 

parameter. 110 

11 

12 

5.2.12 REPLACE t R 13 

1* 

This deletes each group of lines in the specified range 15 

that starts and ends with lines containing the specified text* 116 

and replaces each group of lines with the replacement text. II? 

18 
replace I text=t 11.. t 21 1 tunti t=d! with=t3l f i le=<name> J ..' 119 
Cnumber^nl C I ines=l It .. 1 23 1 tunitl tvetol .. 128 
tsingle_oartitionlmul t impart it ion 3 121 

22 
text % t : This specifies strings of text occurring in 123 
the first and last lines of text to be replaced. If this 325 
parameter is omitted entirely, the lines parameter will 125 
determine the lines to be replaced. If a single text 526 
string is given* a group to be replaced will contain a 12? 
single line. When two text strings are civen. the search 128 
for the second starts immediately after the occurrence of 129 
the first. 138 

31 
until I u I with 1 w 5 file I f 5 See discussion of 132 
replacement text above* 133 

Zh 
number I n : This specifies the maximum number of groups 135 
of lines to be replaced. Number specifies the count of 136 
matching blocks when the text parameter is given and 13? 
individual lines when it is not. This parameter may have 138 
its value given as a number or the keyword ALL. This ?39 
parameter defaults to ALL when a range is given S^f 
explicitly for the lines parameter and to 1 when it is IVt 
not. ihZ 

lines I I s This specifies a range of tines to be scanned !*>5 

for replacement. II can be a line identifier or the ?**5 

keyword ALL. FIRST, CURRENT or LAST. 12 can be a line IkS 

identifier or the keyword CURRENT or LAST. The default \**7 

values supplied if no range is given are CURRENT and 1^8 

COMPANY PRIVATE 



COC SOFTWARE ENGINEERING SYSTEM 

G3/2*/80 
ERS for Source Code Utility (NOS 170 Version) REV* J 

5.0 SCU EDITOR 
5.2.12 REPLACE 1 R 

LAST, 1 t 

2 
unit I un sSee description of unit above* I 

i* 
veto 1 v 8 See description of veto above. % 5 

6 
single_part i tion 1 sp 1 mu 1 1 Impart it ion 5 rap s This 1 ? 
parameter is only meaningful when the FILE keyword is I 8 
used to indicate the source of replacement text. If the 1 9 
MULTI_PARTITION keyword is included on this command* each 118 
er\6 of record encountered in the merge file will be 111 
represented on the source library as a *WEOP text 312 
embedded directive. If the SINGLE_PARTITION keyword is 113 
used or this parameter is omitted entire ly* only the text 11% 
before the first separator on the source file will be 115 
represented on th€ source library. 116 

11 

Examples replace *cal I old* I ines=ALL 518 

call new<pl*p2*p3)/ 19 

20 

21 

5.2.13 SEQUENCE I SEQ J 22 

23 

This command alters the form in which lines from the \2h 

library are displayed by the editor. 125 

26 
sequence on 1 of f 5 separate %2V 

28 
on I off 1 separate * If the ON keyword is used on this 129 
command* the line identifier will precede the text of the 138 
line on the display as part of the same line. If the OFF 131 
keyword is used on this command the line identifier will 132 
not be displayed. If the SEPARATE keyword is used the 5 31 
line identifier will precede the text of a line as a I3*» 
separate line. The initial setting of this option is 135 
taken from the value of the LID field in the header of a 138 
deck when a deck is selected for editing on the EOIT call 13? 
or a OECK command. If LID=N0N£ then SEQUENCE OFF is 138 
selected* otherwise SEQUENCE ON is selected. 139 

<+8 

*♦! 

5.2.1^ STATE U2 

kl 

This command causes the state of the modification 4*i 

associated with the introduction of a text line to be <*5 

displayed when that line is displayed. *>6 

if? 

state onloff U8 
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5.2.15 TAB I T £ 

2 
This command alters the tabbing environment for the I % 
INSERT and REPLACE commands. The user specifies a tab 1 h 
character and columns* The presence of the tab character I 5 
in input text causes blank fill to the next tab column* I 6 
Tab characters entered after the last tab column has been I F 
reached will be accepted as data* Use of the DECK i B 
command causes the default tab selections for the named I 9 
deck to be invoked* llfj 

11 
tab Ccharacter=c1 tcclumns=cl*c2* • **cnl 112 

13 
character I c s This one character string specifies 11% 
the tab character* If this parameter is omitted* 115 
the currently selected tab character will remain in IIS 
effect. II? 

18 
columns I col s This gives tab columns to be 119 
selected* A maximum of 256 tab columns may be 128 
selected at any time* These integers must be in the 21 
range 1 to 256* Multiple columns may be specified 122 
as a value list (see the Parameter Lists section of 123 
the NOS/VE ERS). If this parameter is omitted 125 
entirely the currently selected tab columns nil I 125 
remain in effect* 326 

2? 
Examples tab *V 111*18, 30*36) 2« 

29 

3§ 

5.2*16 VERIFY I V 31 

32 
This command causes the CHANGE command to echo back to the 133 
user the altered line Is). In addition if the verify option is 13% 
selected the first and last lines of a block located by the 135 
FIND command will be displayed or the line will be displayed 136 
if a single line is sought* 13? 

39 
verify onloff 39 

VI 
5*2*17 WIDTH I W %kt 

<*3 

This command declares the number of characters the editor IM* 

will allow to be entered in a text line without Issuing a 1^5 

warning message* Use of the DECK command causes the default IV6 

width from the deck header to be invoked* 1%? 
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5.2.17 WIDTH I W 

width width=n i 1 

2 
width I w : The value for this parameter roust be given as I 3 

an integer from to 256. Specifying will allow lines I % 

of up to 256 characters to be entered. \ 5 

6 

f 

5.2.18 WINDOW 1 WN 18 

9 
This command limits the range of character positions within 18 
a line to be scanned in string searches during subseouent It 
editor commands. Only the characters ir\ the given range are 12 
searched for a match with the string given on the commands 13 
DELETE, LIST, REPLACE, FIND, COPY and CHANGE. IH 

IS 
window Ccolufnns=clC..c2J1 16 

IF 
columns I col s This specifies the starting and ending 118 
scan columns. cl defaults to column 1 and c2 to column 519 
256. 128 

21 
22 
23 
2% 
25 
26 
2? 
28 
29 
38 
31 
32 
33 
3% 
35 
36 
3? 
38 
39 
t+U 
hi 
**Z 
kl 
*** 
kS 
<t& 
<f7 
k9 
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5-3 EOjTQR FUNCTIONS 

Specialized command language functions will be available 
within the version of the SCU editor which executes under 
NOS/VE. They are intended to be used in conjunction with the 
System Command language control statements to aid in altering 
the path taken through sequences of SCU editor commands. 
These functions will not be available in the NOS 170 version. 



5.3.1 $CURRENT__DECK 

This function will return 
selected deck as its value. 



the name of the currently 



5.3.2 $FIRST_DECK 

This function will return the name of the deck which occurs 
first in the directory of the library as its value. 



5.3.3 $LAST_OECK 

This function will return the name of the deck which occurs 
last in the directory of the library as its value. 



5. ft 

On NOS/VE it will be possible to combine SCU editor 
commands and functions with SCL control statements to perform 
repetitive changes that are often necssary in such 
applications as test base maintenance. 



] f 

2 

\ 3 

I ft 

% 3 

I 6 

? ? 

5 8 

9 

10 

111 

12 

113 

II* 

15 

16 

11? 

18 

119 

120 

21 

22 

!2f 

2ft 

125 

126 

2W 

28 

129 

38 

131 

132 

133 

13ft 

35 

36 

3t 

38 

39 

ftB 

ftl 

ft2 

ft 3 

ftft 

ft5 

ft6 

ft 7 

ft« 
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6.0 FEATURES UNPSR CPftSIOWTIfltt 



The features listed in this section are under 
consideration. Some are listed here because it is felt that 
they may prove superfluous* In other cases they are listed 
here because it is questionable whether they are compatible 
with the basic design of the utility or it is not yet clear in 
what form the feature should be supplied. 



6.1 MOflNAHE SQIT9R CQttMANP 

It may prove desirable to provide a editor command similar 
to the MODNAME directive in MODIFY, which would establish a 
default modification name allowing a shorthand form for line 
identifiers. 



6.2 



JLBL1 



LfiliaS 



Currently it is planned that the SCU editor deal with only 
active lines. It may prove desirable for the editor to FIND 
or LIST inactive lines or perform other manipulations on 
inactive lines. 



6.3 RESTORE LINE SPEAKS 



It may prove desirable to provide a RESTORE command in the 
editor, which would clear the inactive flag for lines 
previously deleted. 



^•^ PH&NGES NOT 



IED IN THE £ 



Some SCU commands outside the editor introduce significant 
changes to a source library without being associated with a 
modification name. N> effective method for automating the 
control of this type of change has been devised. Those 
commands of concern in this respect are PURGE_GECK. 
SEQUENCERS CK, PURGE_M0DIFICATION and SEQUENCE_MODIFICATICN. 
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6.0 FEATURES UNDER CONSIDERATION 

6.5 AUTOMATIC MODIFICATION RESEQUENCING 

6.5 AUTOMATIC MODIFICATION RESgQUENCING £ 

2 

It may be desirable to automatically resequence 3 

modifications when their state is raised to 1 fc 

(developmental ). See the SEQUENCE_MODIFICATIGN cottand. 5 

e 

? 

6.6 S3yiflQ.„£PIT fugs 8 

9 

It may be desirable to provide a mechanism for preserving IIS 

an library as permanent without exiting the editor. Ill 

12 

li 

£•? K£Y CHARACTER SUBSTITUTION Xh 

15 

It may be desirable to allow the CHANG£_LIBRAR¥ command to 16 

substitute the key character used on a source library. 11? 

IB 
19 

6.8 COMPARE UTILITY 128 

21 

It may prove useful to supply a utility which could compare 122 

a source file with a deck on an SCU library and produce a set 123 

of editor commands to cause the deck to match the source 12% 

file. 125 

26 
2? 

6.9 £RQr.£S<;Oft £AS50 QECK ^lEQTIQN 128 

29 

It may prove useful to provide a capability to 138 

conditionally write a deck to an expanded text file based on 131 

the contents of the processor field in the deck header. 132 

33 
3* 

6.10 EQITQR HOVE COMMA *0 135 

36 

It may prove useful to provide an editor command to move a 137 

block of text lines from one place in a deck to another. 138 

39 

*a 

**2 
%3 

**5 
<t6 

<tft 
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7.0 PHASED IMPLEMENTATION 



7.0 PHASED IMPLEMENTATION 1 

2 

% 

5 

6 

Current plans are to implement the version of SCU that I f 

executes under NOS 170 in the steps bet oik* Design of the ? 8 

version of SCU to execute on NOS/VE has be§un and 1 9 

impiementat ion will tentatively begin in March of 1980. 118 

II 

1. Ail SCU features will be implemented and tested by 312 
the project by April ,1980. 113 

1* 

2. SCU will be ready for release as part of the SES 515 
tools package, as part of SES Release l«i» currently lif> 
scheduled for July, 1980. 11? 

18 
19 
28 
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8.0 HESSAGES 



8.1 NON-EPITOR Hi 

Below are listed messages issued primarily from non-editor 
SCU procedures. The conditon numbers are shown relative to 
9000. This origin may change on 170 and will change on 
NOS/VE. The letters listed in the severity column stand for E 

error* F - fatal ♦ I - informative and W - warning 
respectively. Where the characters 4-T are shown below some 
string Mill be substituted in the actual message. 

Condition Severity Mes sage 

9001 E file *T not local 



9002 



file +T is not SCU library 



The contents of the file +T are not recognizable by the 
utility as an SCU source library. 

9003 E emoty SCU library - *T 
There are no decks on the SCU library on file +T. 

9004 E deck +T not found 

9005 E mod +T not found 

9006 E conflict in file name - +T 

An Example of when this message is issued is naming the 
same file for two different parameters on a command suet as 
EXM MOONAHE BA=FILE EC=FILE. The message will also be issued 
if the user attempts an operation that would be destructive to 
the result file named on the SCU. GROUP command. 



9007 



duplicate deck name - +T 



The user has mentioned the same deck twice on the same 
command. 



9008 



duplicate mod name - *T 
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8.0 MESSAGES 

8.1 NON-EDITOR MESSAGES 

I 

The user has attempted to create a modi ficat ion tilth the I 2 
same name as one already existing on the source library. 1 I 

% 
90 09 £ deck +T already on library I 5 

6 

The user has attempted to create a deck with the sane name IF 

as one already existing on the source library. t 8 

9 

9010 E etfloty deck - +T 318 

11 
No text lines have ever been introduced into deck +T. 112 

If 

9011 E invalid deck range - *T to *T 115 

15 

One of the deck names given as one of the ends of a range 116 

does not exist on the library or they are not in order of lit 

occurrence on the library. IIS 

19 

9012 E invalid mod range - +T to +T 128 

21 

One of the modification names given as one of the ends of a 122 

range does not exist on the library or they are not in order 121 

of occurrence on the library. Displaying the modification 52% 

list for the library should suggest which. 125 

26 

9013 E invalid parameter value for +T 12? 

21 

An invalid value has been given for parameter *T on the , 129 

command or directive currently being scanned. 5 3© 

31 
901<* E unexpected 4-T encountered 132 

33 

+T is an unexpected text embedded directive CELSE, IFEND or 13* 

TEXTEND) which has been encountered in the text of the deck 135 

currently being processed. 336 

3f 

9015 E expected +T not found 138 

39 

SCU has searched to the end of a deck without encountering ih% 

a matching text embedded directive (IFEND or TEXTEND). Ikl 

<f2 

9016 E user without proper authority !«*3 

%* 

The user has attempted to perform some commmand which is \kS 

restricted to one of the user names assigned authority for the 1^6 

library. Ifcf 

**8 
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8.0 MESSAGES 

8*1 NON-EDITOR MESSAGES 

9017 E deck +T already interlocked 1 I 

2 

9018 E illegal directive +T I € 

4 

The expression given on the displayed *IF text embedded I 5 

directive is not recognizable* 1 6 

? 

9019 E too many nested IF*s I 8 

9 

The user has nested his IE directives beyond the depth 118 

currently processed by SCU 132), 111 

12 

9020 E too many alternate bases 113 

1* 

SCU currently allows the specification of at most 128 115 

libraries on those commands that allow multiple libraries* 316 

1? 

9021 E +T value too large \±% 

19 

+T is the keyword for the parameter which was given a value 120 

too large* 121 

22 
mod *T not state 4 123 

24 
mod *T state 4 525 

26 
+T 12? 

28 

In the case of this message the entire error message is 529 

substituted and should explain itself* 538 

31 
file + T without write permission 532 

3* 
grouping commands* BASE specified* 5311 
RESULT must be specified. 135 

36 
feature +T not found S3? 

38 
group +T not found 139 

48 
different key character on file - +T 141 

42 
line +T in deck + T truncated 343 

44 

The indicated line In the indicated deck was truncated on 145 

an EXPANO_DECK or EXTRACTJDECK command. A larger width will 146 

have to be supplied on the command or the line will have to be 14? 

split. 148 
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8.1 NON-EOITOR MESSAGES 



9031 



interlock violation in deck -i-T 



An interlock violation has occurred for the indicated deck 
during the processing of a COMBtN£_LIBRARY or REPLACE_LI8RARY 
command* 



9090 



unable to allocate +T 



♦T refers to tables allocated In memory such as 
p_raod_naraes* used for the list of modification nates applying 
to a deck. Short of restructuring his libraries there is 
little the user can do to correct this problem. 



9099 



internal error +T 



SCU has detected an internal error explained in the text of* 
+T. An example might be a library pointer out of range. 
There is no remedial action available to the user beyond 
submitting a PSR documenting the problem so that the failure 
wherever it may be can be sought out and corrected. 



£•2 EDITOR MESSAGES 

Below are listed the messages issued by the SCU editor 
procedures* The condition numbers are shown relative to 
8000. This origin may change on NOS 170 and will change on 
NOS/VE* The letters given in the severity column have the 
following signifcance E - error* F - fatal * I - informative 
and M - warning. The characters +T will be replaced with 
other text in the actual messages. 



8001 



Unknown commands +T 



The string of characters *T was not recognizable as an SCU 
editor command. 



8002 



No deck active 



The user has not indicated to which deck on the library 
editor commands are to apply* 



8003 



Base and result files must be different 
files 
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8.2 EDITOR MESSAGES 

800ft E Continue specified for unknown 5 1 

modification +T ! 2 

3 

The user has specified continue on the editor call command 1 ft 

and the modification *T does not exist on the library. 5 5 

Issuing a OISPLAY_MOOIFICATION_LIST command for the library 5 6 

may point out a misspelling. 5 ? 

8 

8005 E Duplicate modification name +T I 9 

It 
The user has called the editor naming a modification name lit 
which already exists on the library without specifying the 112 
CONTINUE keyword. He must either choose a different 113 
modification name or specify the keyword CONTINUE to add to lift 
the named modification. 115 

16 

8006 E Modification +T not in state 51? 

It 

SCU does not allow mod ficat ions in states other than to 119 

be changed. I2§ 

21 

8007 E Invalid Modification name i22 

23 

8008 £ Invalid keyword value for NUMBER - *T 12ft 

25 

The only valid keyword value for the number parameter is 528 

ALL or A. 5 2? 

2« 

8009 E Value for NUMBER must be positive 529 

integer or keyword 138 

31 

8010 E Invalid file name 532 

33 

8011 E Invalid file position specified 53ft 

35 

Valid keywords for file positioning are REWIND or R» 538 

REWIN0_BEFORE or R8» REWINO_AFTER or RA and NO^REWINO or NR. 537 

38 

8012 E Column number too large 13^ 

ft8 

Values for the COLUMNS parameter must be between 1 and Sftt 
256. 5ft2 

ft3 

8013 E Width greater than maximum line length 5ftft 

ft5 
Values for width must be between and 256. Sft6 

ft? 
801ft E Width greater than maximum width for IftS 
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deck I f 

2 

The user has attempted to give a value for width greater i 3 

than that in the deck header on the library. I % 

8015 E Modification name +T too long 16 

f 

8016 £ Line identifier must start with I 8 

modification name 1 9 

IS 

8017 E Sequence number too large 111 

It 

The largest value SCU allows for a sequence number is 118 

2621%3. 11% 

15 

8018 E Sequence number required after 116 

modification name 11? 

18 

8019 E Invalid keyword value *T 119 

28 

An invalid Keyword value has been given for the LINES or I2t 

AFTER/BEFORE parameter. \Zt 

23 

8021 E Keyword ALL cannot be used in a range 12% 

25 

8022 E Range of lines cannot be specified for 126 

a backward search 127 

28 

8023 E Unknown modification name +T 129 

38 

The SCU editor does not recognize +T as the naie of a 131 

modifcation on the library. 132 

33 
802% E Line at end of range is inactive 13% 

35 
The editor operates on active lines only. 136 

37 
8025 £ Last line in range not found after 138 

first line 139 

%8 

8027 E First line in range not found before 1%1 

last line Ikt 

%3 

8028 E First line in range not found l%% 

%5 

8029 £ First line in range not active 1%« 

%? 
The editor operates on active lines only. 3%8 
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8030 E Text string +T not found ! I! 

I 
8 031 I +T occurrences found 1 % 

5 

This message informs the user how many occurrences of a 3 6 

text block were found if the user asked to find all or some f ? 

number greater than existed in the range of lines to be 18 

searched. I 9 

10 
8032 E No active lines in range III 

12 
The editor operates on active lines only. til 

1* 
8Q33 I +T lines to &nd of range 115 

IS 

This message Informs the user how many lines were found in !i$ 

the remainder of the range of lines to be accessed if the user lift 

asked to operate on all lines or some number greater than 119 

exist in the remainder of the range. 328 

21 

8G3«f W tine is longer than maximum line length %Z1 

23 

One of the lines the user has introduced was greater than 12% 

256 characters in length. It has been truncated to 256 125 

characters. 128 

27 

8035 I Begin editing deck +T 528 

29 

8036 E No start of deck I3f 

31 

The structure of the library is not intact. There is no ?32 

remedial action available to the user. 133 

3% 

8037 E History array for line has overflowed 135 

36 

The line in question has been modified more than 255 137 

times. 138 

39 

8038 W Line is longer than current line width !«*8 

hi 

This is a warning that the user has Introduced a line 1**2 

longer than the current line width and should consider I Ml 

splitting the line where appropriate. f^* 

t*S 

8039 E Invalid keyword value for occurrence - !«*6 

*T l*»7 

<*8 
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8.2 EDITOR MESSAGES 



The only acceptable keyword value for the OCCURRENCE 
parameter is LAST or L. 



80^0 



Value for occurrence must be integer or 
keyword 
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9.0 



LU_MSE 



The degree of control necessary over corrections to source 
data blocks being main tained for an individual for his own 
convenience and over the source code for a major operating 
system component being maintained by an integration and 
evaluation group is very different. For that reason the two 
groups of suggestions are offered below. 



9.1 j>RXVAT£.SfiM%QF r POPE HAjNTENANqE 

For the convenience of an individual maintaining a private 
source library it is suggested that he set all authorities to 
his own user name. Probably the only criteria file directive 
that he would need to use would be DECLARE* which is useful in 
allowing alternate blocks of source code to be written to an 
expanded text file. 



9.2 QROUP^lHlESE^Cnog MAINTENANCE 

It is suggested that for maintenance of complex blocks of 
source data that may be required to be accessible to a large 
group of implementors that the authority and interlock 
features of SCU be used to ensure control over modifications 
being made. It is suggested that a user who is assigned the 
responsibility to implement a correction to a particular deck 
extract a subset library containing only the deck that he is 
to modify* setting the Interlock for that deck in the 
process. 

The individual could then enter his correction and make 
trial use of it from his subset source library satisfying 
needs for other decks from the base library specified as an 
alternate. The individual would finally submit his modified 
subset library for code review and combining with the base 
library with the new corrections in state 0. The interlock 
would be cleared when the combine was done* 

As various stages of testing are completed the person in 
authority can grant that the new corrections be raised in 
state or if testing indicates that the correction is not 
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9.0 SUGGESTIONS ON SCU USE 

9.2 GROUP SOURCE CODE MAINTENANCE 

acceptable can lower the state of the correction to state i 
and contact the person responsible to make an adjustment f 
before resubmitting the correction. 3 

h 
Expanded text files can be built with all available 5 
corrections on the base source library to check for conflicts 6 
between developers or at the other extreme can be built with f 
only released code to produce a version of the source data at 1 
some significant milestone* 9 

if 

The DISPLAYS I8RARY, DISPLAY_DECK, DISPLAY_MGOIFICATION, it 

0ISPLAY_GR0UP and similar commands can be used to help 12 

document and evaluate subset source libraries prior to 13 

combining them with the base source library. Ik 

IS 

Criteria files can be used to specify the contents of a If 

complex expanded text file. The contents of these files can 1? 

of course be maintained on the source library themselves, 18 

19 
20 
2f 
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